Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Omni Video (Beta)

post/kling/v1/videos/omni-video

Headers

Content-Typestring

Content type of the request body.

Request body

model_namestring

Optional model ID for this Kling Omni video request. Omit this field to use the route default.

promptstring required

Text prompt describing the desired video. Maximum length is 2,500 characters. When you send image_list, reference the image with <<<image_1>>>.

sound'on' | 'off'

Whether to generate audio with the video. Use on or off.

mode'std' | 'pro'

Generation mode. Use std for standard generation or pro when the selected model supports the higher-quality mode.

aspect_ratio'16:9' | '9:16' | '1:1'

Aspect ratio request for beta Kling Omni generation. The endpoint does not expose an exact size field; a 16:9 text-to-video request can render as 1920x1080.

duration'5' | '10'

Requested output length for text-to-video and first-frame image-reference workflows. Use 5 or 10 as a string.

callback_urlstring uri

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_idstring

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Response

Success

codeinteger required

Response code. 0 means the task request was accepted.

messagestring required

Response message.

request_idstring

Request identifier returned by CometAPI when present.

Example response

{
  "code": 0,
  "message": "SUCCEED",
  "data": {
    "task_id": "<task_id>",
    "task_status": "submitted",
    "task_info": {
      "external_task_id": null
    },
    "task_status_msg": null,
    "created_at": 1773366840306,
    "updated_at": 1773366840306
  }
}