Video

Seedance 2.5*

Most advanced Seedance with 30s clips, native audio, and up to 50 references. Default choice for most video generations — quality is head and shoulders above other models, it supports durations up to 30 seconds, and it outputs up to 1080p. Reach for this first unless the user asks for a specific model, needs 4k output, or cost is the priority.

  • This API endpoint includes Krea prompt enhancement in addition to the base Seedance 2.5 model.
post/generate/video/bytedance/seedance-2-5

Headers

X-Webhook-URLstring uri

URL to receive a POST request when the job completes. The webhook will receive the job data including results.

Request body

promptstring required
start_imagestring uri nullable

Can be an external URL, base64 data URI, or uploaded asset URL.

aspect_ratio'16:9' | '4:3' | '1:1' | '3:4' | '9:16' | '21:9'
end_imagestring uri nullable

Can be an external URL, base64 data URI, or uploaded asset URL.

reference_imagesstring[]
reference_videosstring[]
reference_audiosstring[]
durationnumber
generate_audioboolean
resolution'480p' | '720p' | '1080p'
seedinteger
enhance_promptboolean

When true, rewrites the prompt for Seedance 2 using Krea prompt enhancement before video generation.

draftboolean

When true, generates a fast 480p draft of the video instead of a full-quality one, billed at the 480p rate. Use it to validate scene structure, motion, and prompt intent cheaply before rerunning with draft off. Any resolution sent alongside is ignored.

Response

The resulting job data. This will be returned in a pending state until the job is completed. See /jobs/{id} for retrieving the results.

job_idstring uuid required
status'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled' required
created_atstring date-time required
{"stackTrail":"paths:/generate/video/bytedance/seedance-2-5:post:responses:200:content:application/json:schema:properties:completed_at","oasType":"schema","type":"unknown"}
{"stackTrail":"paths:/generate/video/bytedance/seedance-2-5:post:responses:200:content:application/json:schema:properties:result","oasType":"schema","type":"unknown"}

Changes

Changed in 4 of the 81 revisions of this API.4

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      the response's property pattern was changed from ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ to ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ for the status

      response-property-pattern-changed

    • ○

      added the new 1080p enum value to the request property

      request-property-enum-value-added

    • ○

      endpoint added

      endpoint-added