Skip to main content
POST

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json

Seedance 2.5 image-to-video. Choose one option — Frame and Reference fields are mutually exclusive. prompt is optional. video_urls is not supported on I2V. audio_urls cannot be used alone.

​
first_frame_image
string<uri>
required

Required. Starting frame URL. Do not pass reference_images.

Minimum string length: 1
Example:

"https://example.com/first.jpg"

​
last_frame_image
string<uri>

Optional. Ending frame URL. Requires first_frame_image. Do not pass reference_images.

Minimum string length: 1
Example:

"https://example.com/last.jpg"

​
prompt
string

Optional. Video description. Maximum 10000 characters. Frame animation description.

Required string length: 1 - 10000
Example:

"Animate the scene gently with natural motion"

​
audio_urls
string<uri>[]

Optional. Reference audio URLs (1-10). Use with frame images; audio-only is not supported.

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.