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.

Headers

Idempotency-Key
string

Client-generated idempotency key for safe retries of the same logical video task creation request.

Body

model
string
required

Video model ID.

Example:

"seedance-2.0-mini"

request_type
enum<string>
required

Video request type, such as text-to-video or image-to-video.

Available options:
text-to-video,
image-to-video
Example:

"text-to-video"

prompt
string
required

Text instruction for the video.

Example:

"Waves crashing on rocks, cinematic slow motion"

duration
number
required

Requested duration in seconds. Must be listed in the selected model's capabilities.supported_seconds.

Example:

8

seconds

Compatibility alias for duration.

Example:

8

resolution
string

Requested output resolution. Must be listed in the selected model's capabilities.supported_sizes when provided.

Example:

"720p"

size
string

Compatibility alias for resolution. Legacy models can expose exact sizes such as 1280x720.

Example:

"1280x720"

client_request_id
string

Client-generated request ID for tracing and retry correlation.

Example:

"video-demo-001"

Response

Queued video task

id
string
required

Video task ID.

Example:

"video_task_id"

status
enum<string>
required

Video task status.

Available options:
queued,
in_progress,
completed,
failed,
timeout
Example:

"queued"

outputs
string<uri>[]

Completed output URLs. Empty or omitted until the task is completed.

Example:
error
object

Task error details for failed or timed-out tasks.