Create a Kling Omni video

POST

kling

videos

omni-video

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "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
  }
}

Use this endpoint for the O1-compatible Kling Omni workflow exposed by CometAPI, including text-to-video and first-frame image-referenced generation.

For the complete provider parameter reference, see the Kling Omni Video documentation.

Choose the input mode

Text-to-video: send prompt, mode, aspect_ratio, and duration
First-frame image reference: add image_list items with image_url and type: first_frame, then reference the image in prompt as <<<image_1>>>
Watermarked output: add watermark_info.enabled: true when you need a watermarked video URL in the query response
Model ID: omit model_name to use the route default, or send a tested Omni Video model ID such as kling-video-o1 or kling-v3-omni

Duration and aspect ratio

Setting	Supported values	Default	Boundary behavior
`duration` for text or first-frame video	`"5"`, `"10"`	`"5"`	Send the value as a string and use one of the two fixed generation lengths.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	Required when no first-frame image controls the frame.
`mode`	`std`, `pro`	route default	Send `std` for standard generation or `pro` only when your selected model supports the higher-quality mode.

Kling Omni does not expose an exact size field. Treat aspect_ratio as a frame-shape request; a 16:9 text-to-video request can render as full-HD 1920x1080.

Task flow

Create the Omni task

Submit the request and store the returned task_id.

Poll the Omni task

Continue with Get a Kling Omni video until the task finishes.

Persist the finished video

Move the returned MP4 URL into your own storage if you need durable access.

Authorizations

Authorization

string

header

required

Bearer token authentication. Use your CometAPI key.

Headers

Content-Type

string

Content type of the request body.

Body

application/json

prompt

string

required

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

model_name

string

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

image_list

object[]

Optional first-frame image reference for image-referenced Omni generation.

Show child attributes

sound

enum<string>

default:off

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

Available options:

on,

off

mode

enum<string>

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

Available options:

std,

pro

aspect_ratio

enum<string>

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.

Available options:

16:9,

9:16,

1:1

duration

enum<string>

default:5

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

Available options:

5,

10

watermark_info

object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original result URLs.

Show child attributes

callback_url

string<uri>

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

external_task_id

string

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

Response

200 - application/json

Success

code

integer

required

Response code. 0 means the task request was accepted.

message

string

required

Response message.

data

object

required

Show child attributes

request_id

string

Request identifier returned by CometAPI when present.

Last modified on July 2, 2026

curl https://api.cometapi.com/kling/v1/videos/omni-video \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "model_name": "kling-v3-omni",
      "prompt": "A paper boat drifts across a calm pond at sunrise.",
      "mode": "std",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": "off"
    }'

{
  "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
  }
}

Content moderation

API keys

Choose the input mode

Duration and aspect ratio

Task flow

Authorizations

Headers

Body

Response

​Choose the input mode

​Duration and aspect ratio

​Task flow

Authorizations

Headers

Body

Response

Choose the input mode

Duration and aspect ratio

Task flow