Skip to main content
POST
cURL
This is the Seedance Video Generation API audio video - first frame endpoint. Generate video with synchronized audio based on single first frame image and text prompt. All 4 models supported. Submit async task and return id, use query endpoint to get results.
Usage: Include text (prompt), image_url (first frame, role=first_frame), and optional audio_url (reference audio, role=reference_audio) in content, set generate_audio: true. ratio is adaptive to automatically match first frame image.

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. Must include image_url (first frame), optional text and audio_url

Input content item

resolution
enum<string>
default:720p

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

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

Video aspect ratio, only adaptive supported (auto-matches first frame image)

Available options:
adaptive
duration
integer
default:-1

Video duration (seconds). Range [4, 30] or -1 (smart selection)

generate_audio
boolean
default:true

Whether to generate synchronized audio. true=includes vocals/SFX/BGM, false=silent video

output_format
enum<string>
default:mp4

Output format. Only Seedance 2.5 supported

Available options:
mp4,
mov
watermark
boolean
default:false

Whether to add watermark

return_last_frame
boolean
default:false

Whether to return last frame image

draft
boolean
default:false

Whether to enable draft mode. Only Seedance 2.5 supported

callback_url
string

Callback URL

execution_expires_after
integer
default:172800

Task timeout threshold (seconds). Range [3600, 259200]

priority
integer
default:0

Execution priority. Range [0, 9]

safety_identifier
string

End user identifier, max 64 characters

tools
object[]

Tool configuration

service_tier
enum<string>
default:default

Service tier

Available options:
default

Response

200 - application/json

Task submitted successfully

id
string
required

Task ID

Last modified on October 22, 2026