Skip to main content
POST

Authorizations

Authorization
string
header
required

Bearer YOUR_API_KEY. Manage keys in API Keys.

Body

application/json
model
string
required
Allowed value: "seedance2.5"
prompt
string
required

Video prompt.

Required string length: 1 - 15000
resolution
enum<string>
default:720P

Output resolution.

Available options:
480P,
720P,
1080P
duration

Generation: 4–30 seconds, default 4. For edits, omit or set -1 to follow the source.

Required range: 4 <= x <= 30
aspect_ratio
enum<string>
default:adaptive

For edits, omit or set adaptive to match the source.

Available options:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
reference_images
object[]

References or keyframes.

Maximum array length: 30
reference_videos
object[]

Reference videos or an edit source.

Maximum array length: 10
reference_audios
object[]

Audio-only references are supported.

Maximum array length: 10
generate_audio
boolean
default:true

Cannot be disabled.

Response

Task accepted.

task_id
string
required

Task ID to poll.

model
string
required

Echoes the supplied model ID.

created_at
string<date-time>
required

Task creation time (UTC).

request_id
string
required

Request ID.