Skip to main content
POST

Headers

​
Authorization
string
required

Body

application/json
​
model
enum<string>
required

Model name. Must be seedance-2-0-fast-refs.

Available options:
seedance-2-0-fast-refs
​
prompt
string
required

Text prompt. Chinese: recommended up to 500 characters; English: recommended up to 1000 words.

​
ref_imgs
string<uri>[]

Reference images (up to 9). jpeg/png/webp, ≤30MB each, 300–6000px, aspect ratio 0.4–2.5. Referenced in the prompt as @image1, @image2…

Maximum array length: 9
​
ref_videos
string<uri>[]

Reference videos for camera/motion reference or editing source (up to 3). mp4/mov, 2–15s each and ≤15s total, ≤50MB each. Referenced in the prompt as @video1…

Maximum array length: 3
​
ref_audios
string<uri>[]

Reference audio for background music, effects or voice (up to 3). wav/mp3, 2–15s each and ≤15s total, ≤15MB each. Requires at least one ref_imgs or ref_videos item. Referenced in the prompt as @audio1…

Maximum array length: 3
​
duration
integer
default:5

Any integer from 4 to 15 seconds.

Required range: 4 <= x <= 15
​
quality
enum<string>
default:720p

Output resolution. resolution is accepted as a compatible alias.

Available options:
480p,
720p
​
aspect_ratio
enum<string>
default:16:9

Output aspect ratio. Image-to-video defaults to adaptive. ratio is accepted as a compatible alias.

Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9,
adaptive
​
generate_audio
boolean
default:true

Generate synchronized audio at no additional charge.

​
callback_url
string<uri>

Optional public HTTPS callback URL. custom_callback_url is accepted as a compatible alias.

Response

Task submitted or application-level error.

​
code
integer
required
​
msg
string
required
​
data
object