---
title: "Omni Video (Beta)"
method: POST
path: "/kling/v1/videos/omni-video"
---

# Omni Video (Beta)

`POST /kling/v1/videos/omni-video`

## Headers

- `Content-Type` string

## Request body

- object
  - `model_name` string — Optional model ID for this Kling Omni video request. Omit this field to use the route default.
  - `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>>>`.
  - `image_list` object[] — Optional first-frame image reference for image-referenced Omni generation.
    - `image_url` string, required — Image URL or Base64 image string.
    - `type` 'first_frame', required — Reference role for this image. Use `first_frame` for the first video frame.
  - `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.
  - `watermark_info` object — Watermark options. When `enabled` is `true`, the task can return watermarked result URLs in addition to original result URLs.
    - `enabled` boolean — Whether to request watermarked result URLs.
  - `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`

Success

- object
  - `code` integer, required — Response code. `0` means the task request was accepted.
  - `message` string, required — Response message.
  - `request_id` string — Request identifier returned by CometAPI when present.
  - `data` object, required
    - `task_id` string, required — Task ID generated by the system.
    - `task_status` 'submitted' | 'processing' | 'succeed' | 'failed', required — Task status.
    - `task_info` object, required — Task metadata, including `external_task_id` when supplied.
      - `external_task_id` string, nullable
    - `task_status_msg` string, nullable — Status details when present.
    - `created_at` integer, required — Task creation time as a Unix timestamp in milliseconds.
    - `updated_at` integer, required — Task update time as a Unix timestamp in milliseconds.

---

[API](https://skmtc.net/cometapi/apis/create-api-key.md) · [All operations](https://skmtc.net/cometapi/apis/create-api-key/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cometapi/create-api-key/versions/0863102dbf34/schema)