Skip to main content
POST
cURL
This is the Seedance Video Generation API omni-reference endpoint. Generate new video by fusing multi-modal content based on reference images and videos. All 4 models supported. Submit async task and return id, use query endpoint to get results.
Usage: Include text (prompt), image_url (role=reference_image), video_url (role=reference_video), and optional audio_url (role=reference_audio) in content, set omni_reference_task_type: "reference".

Authorizations

TT-API-KEY
string
header
required

Get your API key from the TTAPI Dashboard.

Body

application/json
model
enum<string>
required

Model ID

Available options:
doubao-seedance-2-5-260628,
doubao-seedance-2-0-260128,
doubao-seedance-2-0-fast-260128,
doubao-seedance-2-0-mini-260615
content
object[]
required

Input content list. Supports text + image_url (reference_image) + video_url (reference_video) + audio_url (reference_audio) combination

Input content item,supported text、image_url、video_url、audio_url、draft_task type

omni_reference_task_type
enum<string>
required

Task type, fixed as reference (reference-to-video). Options: auto=auto detect, reference=reference-to-video, edit=video edit, extend=video extend

Available options:
reference
resolution
enum<string>
default:720p

Video resolution. Seedance 2.5 options: 480p, 720p, 1080p. Default 720p

Available options:
480p,
720p,
1080p
ratio
enum<string>
default:adaptive

Video aspect ratio. Default adaptive (auto), or specify a specific ratio

Available options:
adaptive,
16:9,
4:3,
1:1,
3:4,
9:16,
21:9
duration
integer
default:-1

Video duration (seconds). Range [4, 30] or -1 (smart selection)。duration and frames , frames has higher priority

generate_audio
boolean
default:true

Whether to generate synchronized audio。true=includes vocals/SFX/BGM,false=silent video。only Seedance 2.5/2.0 supported

output_format
enum<string>
default:mp4

Output format. mp4=standard format, mov=high color accuracy (H.264+yuv444p+PCM, for professional post-production).only Seedance 2.5 supported

Available options:
mp4,
mov
watermark
boolean
default:false

Whether to add watermark. true=display 'AI Generated' in bottom-right corner

return_last_frame
boolean
default:false

Whether to return last frame image. true=return jpeg format last frame, usable for continuous videogenerate

draft
boolean
default:false

Whether to enable draft mode. true=generate 480p preview video. Only Seedance 2.5 supported

callback_url
string

Callback URL. Push POST request when task status changes, content matches query API response

execution_expires_after
integer
default:172800

Task timeout threshold (seconds). Range [3600, 259200] (1~72 hours), default 172800 (48 hours)

priority
integer
default:0

Execution priority. Range [0, 9], higher value = higher priority, default 0 (FIFO). Only Seedance 2.5/2.0 supported

safety_identifier
string

End user unique identifier, max 64 characters. Recommend passing hashed string

tools
object[]

Tool configuration. Only Seedance 2.5/2.0 supported

service_tier
enum<string>
default:default

Service tier. Default=online inference, flex=offline inference(price 50%, Seedance 2.5/2.0 not yet supported)

Available options:
default
seed
integer
default:-1

Random seed. Range [-1, 2147483647], -1=random

camera_fixed
boolean
default:false

Whether to fix camera. true=fixed camera (not supported for reference image scenarios)

frames
integer

Number of video frames. Range [29, 289], must satisfy 25+4n format. Alternative to duration, frames has higher priority

Response

200 - application/json

Task submitted successfully

id
string
required

Task ID

Last modified on October 22, 2026