{"default_endpoint":"video","display_name":"","endpoints":[{"content_types":["application/json"],"endpoint":"video","family":"video","kind":"video","lifecycle":{"cancel_path":"","mode":"async","poll_path":"/ai/v1/videos/{id}","status_values":["pending","in_progress","completed","failed","cancelled"]},"method":"POST","modality":"video","path":"/ai/v1/videos","request":{"envelope":"none","schema":{"additionalProperties":false,"allOf":[{"not":{"properties":{"frame_images":{"minItems":1,"type":"array"},"input_references":{"minItems":1,"type":"array"}},"required":["frame_images","input_references"]}},{"if":{"properties":{"frame_images":{"contains":{"properties":{"frame_type":{"const":"last_frame"}},"required":["frame_type"],"type":"object"},"minContains":1,"type":"array"}},"required":["frame_images"]},"then":{"properties":{"frame_images":{"contains":{"properties":{"frame_type":{"const":"first_frame"}},"required":["frame_type"],"type":"object"},"minContains":1}}}},{"if":{"properties":{"extra":{"properties":{"omni_reference_task_type":{"const":"edit"}},"required":["omni_reference_task_type"],"type":"object"}},"required":["extra"]},"then":{"properties":{"aspect_ratio":{"const":"adaptive"},"duration":{"const":-1},"input_references":{"contains":{"properties":{"type":{"const":"video_url"}},"required":["type"],"type":"object"},"minContains":1,"minItems":1,"type":"array"}},"required":["input_references","aspect_ratio","duration"]}},{"if":{"properties":{"extra":{"properties":{"omni_reference_task_type":{"const":"extend"}},"required":["omni_reference_task_type"],"type":"object"}},"required":["extra"]},"then":{"properties":{"aspect_ratio":{"const":"adaptive"},"input_references":{"contains":{"properties":{"type":{"const":"video_url"}},"required":["type"],"type":"object"},"minContains":1,"minItems":1,"type":"array"}},"required":["input_references","aspect_ratio"]}},{"if":{"properties":{"frame_images":{"minItems":1,"type":"array"}},"required":["frame_images"]},"then":{"properties":{"aspect_ratio":{"const":"adaptive"}},"required":["aspect_ratio"]}},{"if":{"properties":{"extra":{"required":["omni_reference_task_type"],"type":"object"}},"required":["extra"]},"then":{"properties":{"input_references":{"minItems":1,"type":"array"}},"required":["input_references"]}}],"properties":{"aspect_ratio":{"anyOf":[{"enum":["16:9","9:16","1:1","4:3","3:4","21:9"],"type":"string","x-sizing":{"kind":"aspect_ratio","mode":"enum"}},{"const":"adaptive","type":"string","x-sizing":{"kind":"aspect_ratio","mode":"adaptive"}},{"type":"null"}],"default":"adaptive","description":"Output aspect ratio, or adaptive to follow the input image when supported by the model.","x-evidence":"strong"},"duration":{"anyOf":[{"const":-1},{"const":4},{"const":5},{"const":6},{"const":7},{"const":8},{"const":9},{"const":10},{"const":11},{"const":12},{"const":13},{"const":14},{"const":15},{"const":16},{"const":17},{"const":18},{"const":19},{"const":20},{"const":21},{"const":22},{"const":23},{"const":24},{"const":25},{"const":26},{"const":27},{"const":28},{"const":29},{"const":30},{"const":null}],"default":-1,"description":"Video duration in seconds.","x-evidence":"strong"},"extra":{"additionalProperties":false,"description":"Vendor-specific long-tail parameter passthrough (passthrough escape hatch; equivalent to OpenRouter provider).","properties":{"execution_expires_after":{"default":172800,"description":"Task timeout (seconds), counted from created_at; marked expired on timeout","maximum":259200,"minimum":3600,"type":"integer","x-doc":"https://www.volcengine.com/docs/82379/1520757","x-providers":{"generate":{"to":["execution_expires_after"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"omni_reference_task_type":{"default":"auto","description":"Seedance 2.5 task mode for omnidirectional reference workflows.","enum":["auto","reference","edit","extend"],"type":"string"},"output_format":{"default":"mp4","description":"Output video container format.","enum":["mp4","mov"],"type":"string"},"priority":{"default":0,"description":"Execution priority; higher runs earlier (queue-jumping within the same endpoint), FIFO at the same level, does not interrupt running tasks. 2.0 series only, not configurable for flex","maximum":9,"minimum":0,"type":"integer","x-doc":"https://www.volcengine.com/docs/82379/1520757","x-providers":{"generate":{"to":["priority"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"return_last_frame":{"default":false,"description":"Return the last-frame image (png, same dimensions, no watermark) for continuous generation","type":"boolean","x-doc":"https://www.volcengine.com/docs/82379/1520757","x-providers":{"generate":{"to":["return_last_frame"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"safety_identifier":{"description":"Unique end-user identifier (ASCII ≤64 chars) for abuse detection; hashing recommended. 2.0 series only","maxLength":64,"pattern":"^[\\x20-\\x7E]*$","type":"string","x-doc":"https://www.volcengine.com/docs/82379/1520757","x-providers":{"generate":{"to":["safety_identifier"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"tools":{"description":"Tools the model can call (object[]); official docs do not expand sub-properties. 2.0 series only","items":{"additionalProperties":false,"properties":{"type":{"enum":["web_search"],"type":"string"}},"required":["type"],"type":"object"},"type":"array","x-doc":"https://www.volcengine.com/docs/82379/1520757","x-providers":{"generate":{"to":["tools"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true},"watermark":{"default":false,"description":"true adds an 'AI-generated' watermark in the bottom-right corner","type":"boolean","x-doc":"https://www.volcengine.com/docs/82379/1520757","x-providers":{"generate":{"to":["watermark"]}},"x-providers-default":"drop","x-source-op":"generate","x-vendor-field":true}},"type":["object","null"],"x-evidence":"strong"},"frame_images":{"allOf":[{"contains":{"properties":{"frame_type":{"const":"first_frame"}},"required":["frame_type"],"type":"object"},"maxContains":1,"minContains":0},{"contains":{"properties":{"frame_type":{"const":"last_frame"}},"required":["frame_type"],"type":"object"},"maxContains":1,"minContains":0}],"description":"First/last frame reference images for image-to-video generation.","items":{"additionalProperties":false,"properties":{"frame_type":{"enum":["first_frame","last_frame"],"type":"string"},"image_url":{"additionalProperties":false,"properties":{"url":{"format":"uri","type":"string"}},"required":["url"],"type":"object"}},"required":["image_url","frame_type"],"type":"object"},"maxItems":2,"type":["array","null"],"x-capability":"supports_first_last_frame","x-evidence":"strong","x-media":{"discriminator":"/frame_type","valuePaths":["/image_url/url"],"variants":{"first_frame":{"kind":"image","role":"first_frame"},"last_frame":{"kind":"image","role":"last_frame"}}},"x-media-ref":true},"generate_audio":{"default":true,"description":"Whether to generate an audio track.","type":["boolean","null"],"x-capability":"supports_audio_gen","x-evidence":"strong"},"input_references":{"allOf":[{"contains":{"properties":{"type":{"const":"image_url"}},"required":["type"],"type":"object"},"maxContains":10,"minContains":0},{"contains":{"properties":{"type":{"const":"video_url"}},"required":["type"],"type":"object"},"maxContains":5,"minContains":0},{"contains":{"properties":{"type":{"const":"audio_url"}},"required":["type"],"type":"object"},"maxContains":5,"minContains":0}],"description":"Guidance media references (image/video/audio) for video generation.","items":{"additionalProperties":false,"properties":{"type":{"enum":["image_url","video_url","audio_url","file","link"],"type":"string"},"url":{"format":"uri","type":"string"}},"required":["type","url"],"type":"object"},"type":["array","null"],"x-capability":"supports_image_input","x-evidence":"strong","x-media":{"discriminator":"/type","valuePaths":["/url"],"variants":{"audio_url":{"kind":"audio","role":"reference"},"image_url":{"kind":"image","role":"reference"},"video_url":{"kind":"video","role":"reference"}}},"x-media-ref":true},"model":{"description":"Model name.","type":"string","x-evidence":"strong","x-skeleton":true},"prompt":{"description":"Text prompt describing the video to generate.","minLength":1,"type":"string","x-evidence":"strong","x-skeleton":true},"resolution":{"anyOf":[{"enum":["480p","720p"],"type":"string","x-sizing":{"kind":"resolution","mode":"enum"}},{"type":"null"}],"default":"720p","description":"Output resolution tier, not exact pixel dimensions.","x-evidence":"strong"},"webhook_url":{"description":"HTTPS webhook callback URL.","format":"uri","type":["string","null"],"x-evidence":"strong"}},"required":["model","prompt"],"type":"object"}},"schema_version":"1.6"}],"family":"video","modality":"video","model":"doubao-seedance-2-5-flash","schema_version":"1.6"}