Skip to main content
POST
Create video task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
enum<string>
required

The video generation model to use.

Available options:
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-2-0-mini
Example:

"doubao-seedance-2-0"

content
object[]
required

Input content items. Text-to-video uses a single text item; add image_url / video_url / audio_url items for image-to-video, multimodal reference, video editing, or extension. First-frame, first+last-frame, and multimodal-reference modes are mutually exclusive.

Example:
generate_audio
boolean
default:true

Generate synchronized voice, sound effects, and background music.

resolution
enum<string>
default:720p

Output resolution.

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

Output aspect ratio.

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

Video duration in seconds.

Required range: 4 <= x <= 15
tools
object[]

Enable web-search-enhanced generation (text-to-video only).

watermark
boolean
default:false

Add a watermark to the output video.

Response

Task created

task_id
string

Platform task ID; pass it to the task query endpoint.

Example:

"asyntask_h81efT0qwtLnzyt6VENmCZ6VXSfNxE2E"