{ "openapi": "3.1.0", "info": { "title": "1Route Unified Video API", "version": "1.1.0", "description": "Canonical JSON contract for 38 public video models. Legacy aliases and integer duration strings remain supported; conflicting aliases are rejected. Model capabilities, reference-duration billing and group permissions still apply." }, "servers": [ { "url": "https://video.1route.dev" } ], "security": [ { "bearerAuth": [] } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer" } }, "schemas": { "Video": { "type": "object", "required": [ "id", "object", "model", "status", "progress", "created_at" ], "properties": { "id": { "type": "string" }, "object": { "const": "video" }, "model": { "type": "string" }, "status": { "enum": [ "queued", "in_progress", "completed", "failed", "expired" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "created_at": { "type": "integer" }, "completed_at": { "type": "integer" }, "expires_at": { "type": "integer" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } }, "metadata": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "generation_status": { "type": "string" }, "delivery_status": { "type": "string" }, "billing_status": { "type": "string" } } } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } }, "paths": { "/v1/models": { "get": { "operationId": "listVideoModels", "responses": { "200": { "description": "Models permitted for the current key" }, "default": { "description": "HTTP error. Never automatically repeat an ambiguous generation POST. Top-level code/message/data may be retained as compatibility aliases.", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } } } } } }, "/v1/videos": { "post": { "operationId": "createVideo", "requestBody": { "required": true, "content": { "application/json": { "schema": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "minimax-h3(933/4-15秒/2K)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "2k" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "minimax-h3(933/4-15秒/768p)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "768p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "minimax-h3(933/2K/支持真人)" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 15, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "2k" ] }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4" ] }, "images": { "type": "array", "items": { "type": "string", "format": "uri", "pattern": "^https?://" }, "maxItems": 9 }, "videos": { "type": "array", "items": { "type": "string", "format": "uri", "pattern": "^https?://" }, "maxItems": 3 }, "audios": { "type": "array", "items": { "type": "string", "format": "uri", "pattern": "^https?://" }, "maxItems": 3 } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "minimax-h3-8img3audio" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 5, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "480p", "768p" ] }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16" ] }, "images": { "type": "array", "items": { "type": "string", "format": "uri", "pattern": "^https?://" }, "maxItems": 8 }, "videos": { "type": "array", "items": { "type": "string", "format": "uri", "pattern": "^https?://" }, "maxItems": 0 }, "audios": { "type": "array", "items": { "type": "string", "format": "uri", "pattern": "^https?://" }, "maxItems": 3 } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "seedance-2.0-mini-12s" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 12, "maximum": 12 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 0, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "seedance-2.5-30img" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 30 }, "resolution": { "type": "string", "minLength": 1, "default": "720p", "description": "Fixed 720p output tier. Other nonempty resolution strings are normalized to 720p." }, "images": { "type": "array", "minItems": 0, "maxItems": 30, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "audios": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9" ] }, "face": { "type": "boolean", "default": false, "description": "Enable colored-pencil preprocessing of reference images; acceptance of every face reference is not guaranteed" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds", "images" ], "properties": { "model": { "type": "string", "const": "seedance-2.0-15s-480p" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 15, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "480p" ] }, "images": { "type": "array", "minItems": 1, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(9-0-0)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 5, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "480p", "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(9-3-3)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 5, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(fast原生过真人933/720P)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(mini9图3音频)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 12, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "480p", "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.5(30图10音)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p", "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 30, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "audios": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.5(10参考图10音频)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p", "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "audios": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.5(9参考图)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p", "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(满血933过人脸720P)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "enum": [ 5, 10, 15 ] }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] }, "face": { "type": "boolean", "default": false, "description": "Optional face processing for human reference images" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0mini(933过人脸720P)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "enum": [ 5, 10, 15 ] }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] }, "face": { "type": "boolean", "default": false, "description": "Optional face processing for human reference images" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.5(满血30-10-10过人脸720P)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "enum": [ 5, 10, 15, 30 ] }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 30, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] }, "face": { "type": "boolean", "default": false, "description": "Optional face processing for human reference images" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(fast903固定15秒720P)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 15, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.5(全参过人脸720P)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 30, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] }, "face": { "type": "boolean", "default": false, "description": "Optional face processing for human reference images" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(933过人脸4-15秒)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] }, "face": { "type": "boolean", "default": false, "description": "Optional face processing for human reference images" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "sd2.0(满血933过人脸4-15秒)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 15 }, "resolution": { "type": "string", "enum": [ "720p" ] }, "images": { "type": "array", "minItems": 0, "maxItems": 9, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 3, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] }, "face": { "type": "boolean", "default": false, "description": "Optional face processing for human reference images" } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "type": "string", "const": "wan3.0(满血10-5-5)" }, "prompt": { "type": "string", "minLength": 1, "maxLength": 2000 }, "seconds": { "type": "integer", "minimum": 4, "maximum": 30 }, "images": { "type": "array", "minItems": 0, "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "const": "reference_image" } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://[^/?#]+/[^?#]*\\.[mM][pP]3(?:\\?[^#]*)?$" } } } ] }, "description": "MP3 audio references only. URL paths must end in .mp3; signed query parameters are allowed. Renaming a non-MP3 file is insufficient." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1" ] } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-image-480p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-image-720p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-image-1080p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "1080p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-image-prime-480p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-image-prime-720p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-image-prime-1080p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "1080p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-video-480p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "url", "seconds" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 15 } } } ] }, "description": "Total reference duration <= 15 seconds; output plus reference duration <= 30 seconds." }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-video-720p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "url", "seconds" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 15 } } } ] }, "description": "Total reference duration <= 15 seconds; output plus reference duration <= 30 seconds." }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-video-1080p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "1080p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "url", "seconds" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 15 } } } ] }, "description": "Total reference duration <= 15 seconds; output plus reference duration <= 30 seconds." }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-video-prime-480p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "480p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "url", "seconds" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 15 } } } ] }, "description": "Total reference duration <= 15 seconds; output plus reference duration <= 30 seconds." }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-video-prime-720p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "720p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "url", "seconds" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 15 } } } ] }, "description": "Total reference duration <= 15 seconds; output plus reference duration <= 30 seconds." }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds" ], "properties": { "model": { "const": "wan3.0-video-prime-1080p" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 2, "maximum": 30 }, "resolution": { "type": "string", "enum": [ "1080p" ], "description": "The model ID determines resolution. This compatibility field does not change the output tier." }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "adaptive" ] }, "images": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 5, "items": { "oneOf": [ { "type": "object", "additionalProperties": false, "required": [ "url", "seconds" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 15 } } } ] }, "description": "Total reference duration <= 15 seconds; output plus reference duration <= 30 seconds." }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds", "resolution" ], "description": "Seconds bounds describe gateway validation, not a generation guarantee. Group and model limits also apply. Start with a short duration.", "properties": { "model": { "const": "doubao-seedance-2-0-260128" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p", "4k" ] }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ] }, "images": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } }, "generate_audio": { "type": "boolean" }, "watermark": { "type": "boolean" }, "seed": { "type": "integer" }, "metadata": { "type": "object", "description": "Legacy native options. Do not override canonical billing fields." } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds", "resolution" ], "description": "Seconds bounds describe gateway validation, not a generation guarantee. Group and model limits also apply. Start with a short duration.", "properties": { "model": { "const": "doubao-seedance-2-0-fast-260128" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ] }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ] }, "images": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } }, "generate_audio": { "type": "boolean" }, "watermark": { "type": "boolean" }, "seed": { "type": "integer" }, "metadata": { "type": "object", "description": "Legacy native options. Do not override canonical billing fields." } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds", "resolution" ], "description": "Seconds bounds describe gateway validation, not a generation guarantee. Group and model limits also apply. Start with a short duration.", "properties": { "model": { "const": "doubao-seedance-2-0-mini-260615" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ] }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ] }, "images": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } }, "generate_audio": { "type": "boolean" }, "watermark": { "type": "boolean" }, "seed": { "type": "integer" }, "metadata": { "type": "object", "description": "Legacy native options. Do not override canonical billing fields." } } }, { "type": "object", "additionalProperties": false, "required": [ "model", "prompt", "seconds", "resolution" ], "description": "Seconds bounds describe gateway validation, not a generation guarantee. Group and model limits also apply. Start with a short duration.", "properties": { "model": { "const": "doubao-seedance-2-5-260628" }, "prompt": { "type": "string", "minLength": 1 }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 }, "resolution": { "type": "string", "enum": [ "480p", "720p", "1080p" ] }, "aspect_ratio": { "type": "string", "enum": [ "16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive" ] }, "images": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "role": { "type": "string", "enum": [ "reference_image", "first_frame", "last_frame" ] } } } ] } }, "videos": { "type": "array", "maxItems": 10, "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" }, "seconds": { "type": "integer", "minimum": 1, "maximum": 3600 } } } ] } }, "audios": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "uri", "pattern": "^https?://" }, { "type": "object", "additionalProperties": false, "required": [ "url" ], "properties": { "url": { "type": "string", "format": "uri", "pattern": "^https?://" } } } ] } }, "generate_audio": { "type": "boolean" }, "watermark": { "type": "boolean" }, "seed": { "type": "integer" }, "metadata": { "type": "object", "description": "Legacy native options. Do not override canonical billing fields." } } } ] } } } }, "responses": { "200": { "description": "Public video task. Download only when completed and metadata.url is available.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "object", "model", "status", "progress", "created_at" ], "properties": { "id": { "type": "string" }, "object": { "const": "video" }, "model": { "type": "string" }, "status": { "enum": [ "queued", "in_progress", "completed", "failed", "expired" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "created_at": { "type": "integer" }, "completed_at": { "type": "integer" }, "expires_at": { "type": "integer" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } }, "metadata": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "generation_status": { "type": "string" }, "delivery_status": { "type": "string" }, "billing_status": { "type": "string" } } } } } } } }, "default": { "description": "HTTP error. Never automatically repeat an ambiguous generation POST. Top-level code/message/data may be retained as compatibility aliases.", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } } } } } }, "/v1/videos/{id}": { "get": { "operationId": "retrieveVideo", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Public video task. Download only when completed and metadata.url is available.", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "object", "model", "status", "progress", "created_at" ], "properties": { "id": { "type": "string" }, "object": { "const": "video" }, "model": { "type": "string" }, "status": { "enum": [ "queued", "in_progress", "completed", "failed", "expired" ] }, "progress": { "type": "integer", "minimum": 0, "maximum": 100 }, "created_at": { "type": "integer" }, "completed_at": { "type": "integer" }, "expires_at": { "type": "integer" }, "error": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" } } }, "metadata": { "type": "object", "properties": { "url": { "type": "string", "format": "uri" }, "generation_status": { "type": "string" }, "delivery_status": { "type": "string" }, "billing_status": { "type": "string" } } } } } } } }, "default": { "description": "HTTP error. Never automatically repeat an ambiguous generation POST. Top-level code/message/data may be retained as compatibility aliases.", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } } } } } }, "/v1/videos/{id}/content": { "get": { "operationId": "downloadVideo", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "description": "Prefer exact metadata.url without a key. Alternatively use this route with your site key; HEAD and Range are supported.", "responses": { "200": { "description": "MP4 bytes", "content": { "video/mp4": { "schema": { "type": "string", "format": "binary" } } } }, "206": { "description": "Requested byte range" }, "410": { "description": "HTTP error. Never automatically repeat an ambiguous generation POST. Top-level code/message/data may be retained as compatibility aliases.", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } } }, "default": { "description": "HTTP error. Never automatically repeat an ambiguous generation POST. Top-level code/message/data may be retained as compatibility aliases.", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } } } } }, "head": { "operationId": "inspectVideoContent", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Video headers" }, "default": { "description": "HTTP error. Never automatically repeat an ambiguous generation POST. Top-level code/message/data may be retained as compatibility aliases.", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "type" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "type": { "type": "string" } } } } } } } } } } } } }