Skip to main content
POST

Headers

Authorization
string
required

Bearer API key, e.g. Bearer sk-....

Example:

"Bearer sk-..."

Body

application/json

Seedance async create body (POST /v1/video/generations).

model
string
required

Video model id. Model ids from the Model Square and Seedance status. Examples: db-sd2.0-1080p, db-sd2.5-1080p, doubao-seedance-2-0-260128-1080p, etc.

Example:

"db-sd2.5-1080p"

prompt
string
required

Text prompt. Subject, scene, camera motion, style. Or use content text part.

Example:

"City night scene, slow push along a wet street, neon reflections"

duration
integer

Duration in seconds (often 4–15). Use -1 to follow reference video length for edit tasks. Alias: seconds.

Example:

5

seconds
string

Duration as string; equivalent to duration.

Example:

"5"

ratio
enum<string>

Aspect ratio. Aliases: size, aspect_ratio.

Available options:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Example:

"16:9"

size
string

Alias of ratio.

aspect_ratio
string

Alias of ratio.

images
string[]

Reference image URLs. Ignored when first/last frames are set.

image
string

Single reference image URL.

first_frame

First frame URL (string or array). Aliases: start_frame, first_frame_url.

last_frame

Last frame URL (string or array). Aliases: end_frame, last_frame_url.

start_frame

Alias of first_frame.

end_frame

Alias of last_frame.

reference_images
string[]

Reference image URLs.

reference_videos
string[]

Reference video URLs.

reference_audios
string[]

Reference audio URLs.

generate_audio
boolean

Whether to generate audio track. Also extra_body.generate_audio.

Example:

true

extra_body
object

Extensions, e.g. generate_audio.

omni_reference_task_type
string

Omni-reference task type (e.g. edit). Often with duration: -1.

Example:

"edit"

content
object[]

Multimodal content parts (alternative to top-level reference_* fields).

Response

Task accepted. Poll with id or task_id.

id
string

Task id for polling.

task_id
string

Same as id.

object
string
status
string

Task status.

progress
any

Progress percent or numeric.

created_at
integer