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. Cite media with @Image1, @Video1, or @Audio1. For editing, declare @Video1 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:

"@Video1 is the sole source and timeline master. Replace only the single lamp in @Video1 with the lamp from @Image1. 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:adaptive

Aspect ratio of the generated video. For video edit and extension, use adaptive or omit; a fixed ratio may fail asynchronously with InvalidParameter.TaskTypeConstraint.

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

"adaptive"

​
resolution
enum<string>
default:720p

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

Available options:
480p,
720p,
1080p
Example:

"720p"

​
duration
enum<integer>
default:5

Video duration in seconds (4-30). For video editing, use -1 or omit; do not specify a fixed output duration. The input video must be 4-30 seconds. Video extension and reference-to-video use 4-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,
-1
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

​
omni_reference_task_type
enum<string>
default:auto

Task type hint for Seedance 2.5 omni reference-to-video (default auto). auto infers from the inputs and prompt. reference generates a new video from references with no extra ratio or duration constraints. edit edits the source video: requires video_urls (4–30s), ratio=adaptive, and duration=-1. extend extends the source video: requires video_urls and ratio=adaptive. The model still infers the type from the prompt; a mismatch can fail asynchronously.

Available options:
auto,
reference,
edit,
extend
Example:

"edit"

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.