v1

latestOpenAPI 3.1.0Commercial2026-07-26232551.7 KB
Video

Submit a video task

Submit an async video-generation task.

The request body shape depends on the model prefix:

  • kling/... — Kling video request. Body fields are prompt + image + metadata.{mode, aspect_ratio, duration, image_list, video_list, sound, multi_shot, ...}. Endpoint variant (text-to-video / image-to-video / Omni-Video) is selected by which metadata fields you supply.
  • byteplus/... — Seedance video request. Body fields are prompt + metadata.{content[], ratio, duration, generate_audio, watermark, seed, service_tier, return_last_frame, callback_url, resolution}. The variant (text-to-video / image-to-video / multimodal reference / video editing) is selected by which content[] items and role markers you supply.

Pick the schema variant from the request body dropdown below to see each shape's fields and try them in the playground.

post/video/generations

Request body

OR

Example request

{
  "model": "kling/kling-v3-omni"
}

Response

Task accepted (async — poll /v1/video/generations/{task_id})

idstring

Task ID. Same value as task_id (kept for legacy clients).

task_idstring
object'video'
modelstring

Model name as the customer sent it (alias / namespace prefix preserved, not the upstream-resolved name).

status'queued'

Always queued on a successful submit.

progressinteger
created_atinteger

Unix timestamp when the task was submitted.