SEseedance2ai
Video

Generate a Seedance 2.0 video

Generate a 4–15 second video from text, a start image, or up to 12 image/video references.

Rules: image_url is required when mode=image-to-video; media_urls is required when mode=media-to-video. resolution 1080p-plus and 4k require quality_tier=pro.

Accepted resolution labels depend on the account; the API documentation lists the values that apply to the key owner. Some quality tiers require a successful credits or plan purchase and otherwise return purchase_required (HTTP 403).

Write the prompt as concrete director instructions: subject, scene, action, camera movement, and order of events.

post/api/v1/video/seedance2

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'
quality_tier'mini' | 'standard' | 'pro'
channel'standard' | 'real' | 'wild'
promptstring required
aspect_ratio'1:1' | '21:9' | '4:3' | '3:4' | '16:9' | '9:16' | 'adaptive'
duration'4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15'
resolution'480p' | '720p' | '1080p' | '1080p-plus' | '4k'
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
fixed_lensboolean
seedinteger

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'seedance2' required
credits_usednumber

Credits charged for this task.

remaining_creditsnumber

Changes

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