{"servers":[{"url":"https://api.modellix.ai/api/v1/bytedance/seedance-2.5-i2v"}],"post":{"description":"[Core Function] Seedance 2.5 I2V is ByteDance Dreamina Seedance 2.5 image-to-video generation supporting first-frame, first-and-last-frame, and reference-image modes. [Strengths] It supports up to 30 reference images, optional reference audio, 4-30 second duration, and mp4 or mov output. [Best For] Highly recommended for: animating a keyframe, first-to-last transitions, multi-image character consistency, and image-led storytelling on Seedance 2.5. [Limitations] Do NOT mix first_frame_image or last_frame_image with reference_images. Do NOT send video_urls on I2V. Do NOT use audio_urls alone. Do NOT use this model when the user requires 1080p or 4k output. [Routing] Prefer this model for Seedance 2.5 image-driven generation. Use Seedance 2.5 T2V for text-only requests and Seedance 2.5 V2V when reference video is required.","operationId":"seedance25I2vAsync","requestBody":{"content":{"application/json":{"examples":{"first_frame":{"summary":"First-frame generation","value":{"duration":12,"first_frame_image":"https://example.com/first.jpg","output_format":"mp4","prompt":"Animate gently with natural camera motion"}},"first_last":{"summary":"First-and-last-frame generation","value":{"duration":8,"first_frame_image":"https://example.com/first.jpg","last_frame_image":"https://example.com/last.jpg","prompt":"Smoothly transition between the two frames","ratio":"16:9"}},"reference_images":{"summary":"Reference-image generation","value":{"audio_urls":["https://example.com/voice.mp3"],"duration":10,"output_format":"mov","prompt":"Combine the subjects from the reference images into one cinematic shot","reference_images":["https://example.com/person.jpg","https://example.com/scene.jpg"]}}},"schema":{"description":"Seedance 2.5 image-to-video. Choose **one** option — Frame and Reference fields are mutually exclusive. `prompt` is optional. `video_urls` is not supported on I2V. audio_urls cannot be used alone.","oneOf":[{"$ref":"#/components/schemas/Seedance25I2vFrameOption","description":"First-frame or first-to-last-frame animation.","title":"Option 1 — Frame mode"},{"$ref":"#/components/schemas/Seedance25I2vReferenceOption","description":"Multimodal reference images with optional audio.","title":"Option 2 — Reference mode"}]}}},"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 I2V","x-mint":{"href":"bytedance/seedance-2-5-i2v"}}}