{"servers":[{"url":"https://api.modellix.ai/api/v1/bytedance/seedance-2.5-flash-v2v"}],"post":{"description":"ByteDance's fast video model for editing, extending, or creating a new clip from reference video, with native sound. It accepts up to five videos with optional image and audio references and produces 480p or 720p output.","operationId":"seedance25FlashV2vAsync","requestBody":{"content":{"application/json":{"examples":{"edit":{"summary":"Video editing","value":{"duration":-1,"generate_audio":true,"omni_reference_task_type":"edit","output_format":"mov","prompt":"Edit @Video1: replace the lamp with the lamp shown in @Image1. Preserve the original camera, motion, and audio.","ratio":"adaptive","reference_images":["https://example.com/replacement_lamp.jpg"],"video_urls":["https://example.com/edit_input.mov"]}},"extension":{"summary":"Video extension","value":{"duration":12,"generate_audio":true,"omni_reference_task_type":"extend","prompt":"Extend @Video1 with a scene that continues its motion and visual style.","ratio":"adaptive","reference_images":["https://example.com/curator_identity.jpg","https://example.com/display_case.jpg"],"resolution":"720p","video_urls":["https://example.com/source_curator_case.mp4"]}},"reference":{"summary":"Reference-to-video","value":{"duration":10,"omni_reference_task_type":"reference","output_format":"mp4","prompt":"Create a new scene using the motion in @Video1 and the visual style in @Image1.","ratio":"16:9","reference_images":["https://example.com/style.jpg"],"video_urls":["https://example.com/clip.mp4"]}}},"schema":{"description":"Generate, edit, or extend a video using video references, with optional image and audio references. At most 20 reference assets in total.","properties":{"audio_urls":{"description":"Reference audio in WAV or MP3 format, each 2-30 seconds and at most 30 seconds in total.","example":["https://example.com/bgm.mp3"],"items":{"format":"uri","type":"string"},"maxItems":5,"minItems":1,"type":"array"},"duration":{"description":"Output duration in seconds. For editing, omit this field or set -1 to preserve the source duration. For reference generation and extension, set 4-30 or use -1 for automatic duration.","enum":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,-1],"example":5,"type":"integer"},"execution_expires_after":{"default":172800,"description":"Maximum time in seconds before the task expires.","example":172800,"maximum":259200,"minimum":3600,"type":"integer"},"generate_audio":{"default":true,"description":"Whether to generate an audio track with the video","example":true,"type":"boolean"},"omni_reference_task_type":{"default":"auto","description":"reference generates a new video from references; edit modifies the source video; extend continues it. auto infers the task from the prompt and inputs.","enum":["auto","reference","edit","extend"],"example":"edit","type":"string"},"output_format":{"default":"mp4","description":"Output video container format.","enum":["mp4","mov"],"example":"mp4","type":"string"},"prompt":{"description":"Editing, extension, or generation instruction. Refer to inputs with @Image1, @Video1, or @Audio1.","example":"Replace the lamp in @Video1 with the lamp from @Image1 while preserving the camera movement and original audio.","maxLength":10000,"minLength":1,"type":"string"},"ratio":{"default":"adaptive","description":"Only an explicit omni_reference_task_type=reference uses your chosen aspect ratio. For auto, edit, extend, or an omitted task type, the platform replaces any supplied ratio with adaptive and bills using adaptive.","enum":["16:9","4:3","1:1","3:4","9:16","21:9","adaptive"],"example":"adaptive","type":"string"},"reference_images":{"description":"Reference images. Use publicly accessible HTTPS URLs or asset:// IDs.","example":["https://example.com/style.jpg"],"items":{"format":"uri","type":"string"},"maxItems":10,"minItems":1,"type":"array"},"resolution":{"default":"720p","description":"Output resolution.","enum":["480p","720p"],"example":"720p","type":"string"},"return_last_frame":{"default":false,"description":"Whether to return the last frame of the generated video","example":false,"type":"boolean"},"video_urls":{"description":"Reference videos, each 2-30 seconds; editing sources must be 4-30 seconds. At most 30 seconds of video in total. Use publicly accessible HTTPS URLs or asset:// IDs.","example":["https://example.com/edit_input.mov"],"items":{"description":"HTTPS URL or `asset://<asset_id>`.","format":"uri","type":"string"},"maxItems":5,"minItems":1,"type":"array"}},"required":["video_urls"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"code":{"description":"Response code, 0 indicates success","example":0,"type":"integer"},"data":{"description":"Detailed data about the submitted asynchronous task.","properties":{"get_result":{"description":"API information to query the task result","properties":{"method":{"description":"HTTP method","example":"GET","type":"string"},"url":{"description":"Full URL to query the task result","example":"https://api.modellix.ai/api/v1/tasks/task-abc123","type":"string"}},"type":"object"},"model_id":{"description":"Model ID","example":"model-123","type":"string"},"status":{"description":"Task status","enum":["pending","processing"],"example":"pending","type":"string"},"task_id":{"description":"Unique task identifier","example":"task-abc123","type":"string"}},"required":["status","task_id","model_id"],"type":"object"},"message":{"description":"Response message","example":"success","type":"string"}},"required":["code","message","data"],"type":"object"}}},"description":"Task submitted successfully"}},"summary":"Seedance 2.5 Flash V2V","x-mint":{"href":"bytedance/seedance-2-5-flash-v2v"}}}