Skip to Content
Video ModelsSeedance 2.5

Seedance 2.5

Overview

Seedance 2.5 is ByteDance’s next-generation AI video model, built for up to 30-second video generation, advanced multimodal reference control, precise local editing, and more flexible, production-ready creative workflows.

Test API KEY: key_00000000000000000000000000000000

Endpoints

1. Create Task

Request

POST https://api.pixwithapi.online/api/task/create

Headers

HeaderValueRequired
Content-Typeapplication/jsonYes
Api-Key{API_KEY}Yes

Request Parameters

ParameterTypeRequiredDescription
promptstringYesThe video generation prompt.
image_urlsarrayConditionalProvide one required first-frame image and an optional second last-frame image for image-to-video mode. Omit for text-to-video mode.
model_idstringYes2-80
optionsobjectYesGeneration options.
options.prompt_optimizationbooleanNoTranslate and optimize the prompt before generation. Default: false.
options.aspect_ratiostringNoOutput aspect ratio. Text-to-video valid values: 'Auto', '16:9', '4:3', '1:1', '3:4', '9:16', '21:9'. Image-to-video (first/last frame) only supports 'Auto'. Default: 'Auto'.
options.resolutionstringNoOutput resolution. Valid values: '480p', '720p', '1080p'. Default: '480p'.
options.durationintNoOutput duration in seconds. Valid values: 5, 10, 15, 20, 25, 30. Default: 5.
options.enable_web_searchbooleanNoText-to-video only. Enable online search for generation context. Default: true. Ignored for image-to-video.
options.soundbooleanNoGenerate synchronized audio. Default: true.

Example Request — Text-to-Video

{ "prompt": "A cinematic tracking shot through a rainy neon city at night", "model_id": "2-80", "options": { "prompt_optimization": true, "aspect_ratio": "16:9", "resolution": "1080p", "duration": 10, "enable_web_search": true, "sound": true } }

Example Request — Start and End Frame

{ "prompt": "Move smoothly from the opening composition into the final frame", "image_urls": [ "https://cdn.pixwithapi.online/images/example-first-frame.jpg", "https://cdn.pixwithapi.online/images/example-last-frame.webp" ], "model_id": "2-80", "options": { "prompt_optimization": true, "aspect_ratio": "Auto", "resolution": "480p", "duration": 15, "sound": true } }

Response Parameters

ParameterTypeDescription
codeint1=success, 0=error
messagestringSuccess and failure messages
dataobject
data.task_idstringTask identifier.
data.estimated_timeintEstimated time in seconds.

Response

{ "code": 1, "message": "success", "data": { "task_id": "d425ab4dc256f0ebaa84862b9cea8a3d", "estimated_time": 500 } }

2. Create Task With R2V

Seedance 2.5 R2V generates video from a prompt and reference media. Reference images help keep the subject consistent; optional videos and audio can guide motion and sound. It supports 1–10 images, up to 5 videos, and up to 5 audio clips.

ParameterTypeRequiredDescription
model_idstringYes2-81.
promptstringYesVideo generation prompt, 1–12,000 characters.
reference_urlsobjectYesReference media URLs; use this instead of image_urls.
reference_urls.reference_imagesarray of URLsYes1–10 reference images.
reference_urls.reference_videosarray of URLsNoUp to 5 reference videos.
reference_urls.reference_audiosarray of URLsNoUp to 5 reference audio clips.
optionsobjectNoOutput settings. Omitted fields use the defaults below.
options.prompt_optimizationbooleanNoTranslate and optimize the prompt before generation. Default: true.
options.aspect_ratiostringNoOutput aspect ratio: Auto, 16:9, 4:3, 1:1, 3:4, 9:16, or 21:9. Default: Auto.
options.resolutionstringNoOutput resolution: 480p, 720p, or 1080p. Default: 480p.
options.durationintNoOutput duration in seconds: 5, 10, 15, 20, 25, or 30. Default: 5.
options.soundbooleanNoGenerate synchronized audio. Default: true.
{ "model_id": "2-81", "prompt": "Keep the subject consistent with the reference image and motion", "reference_urls": { "reference_images": ["https://media.example.com/subject.png"], "reference_videos": ["https://media.example.com/motion.mp4"], "reference_audios": [] }, "options": { "prompt_optimization": true, "aspect_ratio": "Auto", "resolution": "720p", "duration": 10, "sound": true } }

Response

{"code":1,"message":"success","data":{"task_id":"d425ab4dc256f0ebaa84862b9cea8a3d"}}
Last updated on