Skip to main content
POST
Seedance 2.5 Reference to Video

Authorizations

Authorization
string
header
required

All endpoints require Bearer Token authentication

Add the following request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json
model
string
default:seedance-2.5-reference-to-video
required

seedance-2.5-reference-to-video: Generate video from reference images, videos, or audio.

Example:

"seedance-2.5-reference-to-video"

prompt
string
required

Describe the video you want to generate.

Minimum string length: 1
Example:

"A static shot of a small blue ball slowly rolling from left to right on a white table."

resolution
string
default:720p

Output video resolution. The system uses this value to select a model version that can handle the request.

Example:

"480p"

aspect_ratio
string
default:9:16

Output video aspect ratio.

Example:

"16:9"

duration
integer
default:5

Output video duration in seconds. Available durations for each model version are further checked against the current capability catalog.

Required range: 4 <= x <= 30
Example:

4

image_urls
string[]

List of reference image URLs.

Example:
video_urls
string[]

List of reference video URLs.

Example:
audio_urls
string[]

List of reference audio URLs.

Example:

Response

Task created successfully

created
integer

Task creation timestamp

Example:

1757165031

id
string

Task ID

Example:

"task-unified-1757165031-uyujaw3d"

model
string

Name of the model used

object
enum<string>

Specific task object type

Available options:
video.generation.task
progress
integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100
Example:

0

status
enum<string>

Task status

Available options:
pending,
processing,
completed,
failed
Example:

"pending"

task_info
object

Asynchronous task information

type
enum<string>

Task output type

Available options:
video
Example:

"video"