SEseedance2ai
Video

Generate a Seedance 2.5 video

Generate a 4–30 second video, or pass duration "auto" to let the model choose the length. Accepts up to 30 reference images, 10 videos, and 10 audio clips (audio-only input is supported).

Rules: image_url is required when mode=image-to-video; media_urls is required when mode=media-to-video. Image-to-video follows the start frame's aspect ratio; editing or extending a video requires aspect_ratio=adaptive.

Accepted resolution labels depend on the account: most accounts use 720p, 1080p and 1080p-plus. The API documentation lists the values that apply to the key owner, and a value the account cannot use returns HTTP 400 with allowed_resolutions.

Requires a successful credits or plan purchase on the key owner's account; otherwise returns purchase_required (HTTP 403). With duration "auto", credits are reserved at the 30-second ceiling and the difference is refunded when the clip is ready.

Use channel "real" when reference images or videos contain real people.

post/api/v1/video/seedance25

Request

Headers

Idempotency-Keystring

Strongly recommended on every POST. Once a request has created (and charged for) a task, a retry with the same key and the same body within 24 hours replays that response instead of creating a second paid task. Errors raised before anything was charged, such as insufficient_credits or service_busy, are not replayed, so after fixing the cause the same key runs the request again. Reusing a key with a different body, or while the first request is still running, returns idempotency_conflict (HTTP 409). Surrounding whitespace is trimmed; keys longer than 120 characters are ignored, which disables the protection.

Request body

mode'text-to-video' | 'image-to-video' | 'media-to-video'
promptstring required
channel'standard' | 'real' | 'wild'
aspect_ratio'1:1' | '21:9' | '4:3' | '3:4' | '16:9' | '9:16' | 'adaptive'
duration'auto' | '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'
resolution'480p' | '720p' | '1080p' | '1080p-plus'
image_urlstring uri

A publicly reachable https URL. asset:// URLs are not accepted.

end_image_urlstring uri

A publicly reachable https URL. asset:// URLs are not accepted.

media_urlsstring[]
generate_audioboolean

Response

Task accepted. Poll GET /api/v1/tasks/{id} with the returned id (prefix sd2_) until status is completed or failed, and read the files from result_urls there.

idstring required
status'processing' | 'completed' required

Usually processing. A channel that waits for the image inside the request returns completed; the task's result_urls are then ready at GET /api/v1/tasks/{id}.

model'seedance25' required
credits_usednumber

Credits charged for this task.

remaining_creditsnumber

Changes

No recorded changes to this operation across all 1 revision of this API.