From 91c3bf084bd4952cc51ce6e114ba71dea604ade2 Mon Sep 17 00:00:00 2001
From: localai-org-maint-bot <bot-opensource@localaisrl.com>
Date: Wed, 14 Oct 2026 01:06:34 +0200
Subject: [PATCH] feat(swagger): update swagger (#12674)

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: mudler <2420543+mudler@users.noreply.github.com>
---
 swagger/docs.go      | 41 +++++++++++++++++++++++++++++++++++++++++
 swagger/swagger.json | 41 +++++++++++++++++++++++++++++++++++++++++
 swagger/swagger.yaml | 29 +++++++++++++++++++++++++++++
 3 files changed, 111 insertions(+)

diff --git a/swagger/docs.go b/swagger/docs.go
index 1ecc813bd..2880cf1f4 100644
--- a/swagger/docs.go
+++ b/swagger/docs.go
@@ -9458,6 +9458,26 @@ const docTemplate = `{
                 }
             }
         },
+        "schema.VideoReference": {
+            "type": "object",
+            "properties": {
+                "audio": {
+                    "description": "optional audio paired with this video",
+                    "type": "string"
+                },
+                "fps": {
+                    "description": "frame rate of the source frames; 0 means the backend default",
+                    "type": "integer"
+                },
+                "frames": {
+                    "description": "ordered frame images: URL, base64 or data URI",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
         "schema.VideoRequest": {
             "type": "object",
             "properties": {
@@ -9507,6 +9527,27 @@ const docTemplate = `{
                     "description": "text description of the video to generate",
                     "type": "string"
                 },
+                "ref_audios": {
+                    "description": "reference audio clips (WAV); exclusive with start_image/end_image",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "ref_images": {
+                    "description": "reference images (URL, base64 or data URI); exclusive with start_image/end_image",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "ref_videos": {
+                    "description": "reference videos as frame lists; exclusive with start_image/end_image",
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/schema.VideoReference"
+                    }
+                },
                 "response_format": {
                     "description": "output format (url or b64_json)",
                     "type": "string"
diff --git a/swagger/swagger.json b/swagger/swagger.json
index 1b034416d..b5825d5fe 100644
--- a/swagger/swagger.json
+++ b/swagger/swagger.json
@@ -9455,6 +9455,26 @@
                 }
             }
         },
+        "schema.VideoReference": {
+            "type": "object",
+            "properties": {
+                "audio": {
+                    "description": "optional audio paired with this video",
+                    "type": "string"
+                },
+                "fps": {
+                    "description": "frame rate of the source frames; 0 means the backend default",
+                    "type": "integer"
+                },
+                "frames": {
+                    "description": "ordered frame images: URL, base64 or data URI",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
         "schema.VideoRequest": {
             "type": "object",
             "properties": {
@@ -9504,6 +9524,27 @@
                     "description": "text description of the video to generate",
                     "type": "string"
                 },
+                "ref_audios": {
+                    "description": "reference audio clips (WAV); exclusive with start_image/end_image",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "ref_images": {
+                    "description": "reference images (URL, base64 or data URI); exclusive with start_image/end_image",
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "ref_videos": {
+                    "description": "reference videos as frame lists; exclusive with start_image/end_image",
+                    "type": "array",
+                    "items": {
+                        "$ref": "#/definitions/schema.VideoReference"
+                    }
+                },
                 "response_format": {
                     "description": "output format (url or b64_json)",
                     "type": "string"
diff --git a/swagger/swagger.yaml b/swagger/swagger.yaml
index b01b7b441..623af08fe 100644
--- a/swagger/swagger.yaml
+++ b/swagger/swagger.yaml
@@ -3429,6 +3429,20 @@ definitions:
       model:
         type: string
     type: object
+  schema.VideoReference:
+    properties:
+      audio:
+        description: optional audio paired with this video
+        type: string
+      fps:
+        description: frame rate of the source frames; 0 means the backend default
+        type: integer
+      frames:
+        description: 'ordered frame images: URL, base64 or data URI'
+        items:
+          type: string
+        type: array
+    type: object
   schema.VideoRequest:
     properties:
       audio:
@@ -3465,6 +3479,21 @@ definitions:
       prompt:
         description: text description of the video to generate
         type: string
+      ref_audios:
+        description: reference audio clips (WAV); exclusive with start_image/end_image
+        items:
+          type: string
+        type: array
+      ref_images:
+        description: reference images (URL, base64 or data URI); exclusive with start_image/end_image
+        items:
+          type: string
+        type: array
+      ref_videos:
+        description: reference videos as frame lists; exclusive with start_image/end_image
+        items:
+          $ref: '#/definitions/schema.VideoReference'
+        type: array
       response_format:
         description: output format (url or b64_json)
         type: string