Video

Submit a video task

Changed on

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.
  • minimax/... — MiniMax-H3 video request. Body fields are prompt + duration + size + image/images + metadata.{ratio, first_frame_image, last_frame_image, video_urls, audio_urls, callback_url}. The variant (text-to-video / image-to-video / multimodal reference) is selected by which image / reference fields you supply; every video ships with native stereo audio.

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

  • Base URL
    https://api.orcarouter.ai/v1
  • URL
    https://api.orcarouter.ai/v1/video/generations
  • Auth
    HTTP bearer

Request body

OR
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.

Changes