Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

video_urls is required (1-10). Optional prompt, reference_images (up to 30), and audio_urls (up to 10). First/last frame parameters are not supported.

​
video_urls
string<uri>[]
required

Required reference video URLs (1-10) used as edit source, extension base, or multimodal references

Required array length: 1 - 10 elements
Example:
​
prompt
string

Optional editing, extension, or generation instruction. You may cite media with placeholders such as [Image 1], [Video 1], or [Audio 1]. For editing, declare [Video 1] as the sole timeline master, name the edit scope, and list what must be preserved. For extension, define how the new segment connects at the source boundary. Maximum 10000 characters

Required string length: 1 - 10000
Example:

"[Video 1] is the sole source and timeline master. Replace only the single lamp in [Video 1] with the lamp from [Image 1]. Preserve the actor, room, camera, motion, and original audio."

​
reference_images
string<uri>[]

Optional reference image URLs (1-30)

Required array length: 1 - 30 elements
Example:
​
audio_urls
string<uri>[]

Optional reference audio URLs (1-10). Must accompany video_urls

Required array length: 1 - 10 elements
Example:
​
ratio
enum<string>
default:16:9

Specifies the aspect ratio for the generated video

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

"16:9"

​
resolution
enum<string>
default:720p

Specifies the resolution tier for the generated video. Seedance 2.5 supports 480p and 720p only

Available options:
480p,
720p
Example:

"720p"

​
duration
enum<integer>
default:5

Video duration in seconds. Allowed values are integers from 4 to 30

Available options:
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
27,
28,
29,
30
Example:

5

​
seed
integer
default:-1

Random number seed for reproducibility. Use -1 for random. Identical seeds cannot guarantee completely identical results

Required range: -1 <= x <= 4294967295
Example:

-1

​
camera_fixed
boolean
default:false

Whether to keep the camera fixed during generation

Example:

false

​
generate_audio
boolean
default:true

Whether to generate an audio track with the video

Example:

true

​
output_format
enum<string>
default:mp4

Output video container. mp4 for general playback; mov for higher color precision in editing workflows

Available options:
mp4,
mov
Example:

"mp4"

​
execution_expires_after
integer
default:172800

Task expiration time in seconds

Required range: 3600 <= x <= 259200
Example:

172800

​
return_last_frame
boolean
default:false

Whether to return the last frame of the generated video

Example:

false

Response

200 - application/json

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required

Detailed data about the submitted asynchronous task.