Chuyển đến nội dung chính
POST
/
kling
/
v1
/
videos
/
omni-video
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "The boy in <<<image_1>>> is wearing <<<element_1>>> and, together with the girl in <<<image_2>>>, sits side by side in <<<element_2>>>, playfully and intimately chatting, close-up shot."
}
'
{}
Sử dụng endpoint này cho các quy trình Kling Omni, bao gồm text-to-video thuần, tạo bằng tham chiếu hình ảnh và các luồng biến đổi video.

Chọn chế độ đầu vào

  • Text-to-video: gửi prompt, mode, aspect_ratio, và duration
  • Tạo bằng tham chiếu hình ảnh: thêm image_list
  • Tạo có hướng dẫn theo phần tử: thêm element_list
  • Biến đổi video: thêm video_list với refer_type: base

Quy trình tác vụ

1

Tạo tác vụ Omni

Gửi request và lưu task_id được trả về.
2

Polling tác vụ Omni

Tiếp tục với Omni Query cho đến khi tác vụ hoàn tất.
3

Lưu trữ video đã hoàn tất

Chuyển URL MP4 được trả về vào hệ thống lưu trữ của riêng bạn nếu bạn cần quyền truy cập bền vững.
Việc xác thực trực tiếp vào ngày 2026-03-12 đã xác nhận rằng một request text-to-video tối thiểu trả về task_status: submitted, và truy vấn Omni tiếp theo sau đó đã đạt SUCCESS cùng với URL MP4 cuối cùng.

Ủy quyền

Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tiêu đề

Content-Type
string

Content type of the request body.

Nội dung

application/json
prompt
string
mặc định:Hello
bắt buộc

Text prompt describing the desired video. Max 2500 characters. Reference images or elements inline using <<<image_1>>>, <<<element_1>>>, <<<video_1>>> syntax.

model_name
string

Model to use. Currently only kling-video-o1 is supported.

image_list
object[]

Reference images for the generation. Each entry can optionally include a type field set to first_frame or end_frame to pin the image as the video's start or end frame. Accepts URLs or Base64 strings. Formats: JPG, JPEG, PNG. Max 10 MB per image, minimum 300 px per side, aspect ratio 1:2.5–2.5:1. When used with reference videos, image + element count must not exceed 4; without reference videos, the limit is 7.

element_list
object[]

Pre-registered element references by ID. Combined with images, the total count must not exceed 4 (with reference video) or 7 (without).

mode
string

Generation mode. std (standard, faster and more cost-effective) or pro (professional, higher quality output).

aspect_ratio
string

Output video aspect ratio (width:height). Values: 16:9, 9:16, 1:1. Required when not using a first-frame reference image or video editing.

duration
string

Video length in seconds. Values: 3–10. Text-to-video and first-frame-to-video only support 5 and 10. When editing an existing video, duration matches the input and this parameter is ignored.

video_list
string[]

Reference video for style transfer or the base video to edit. Use refer_type to distinguish: feature for style reference, base for the video to modify. Set keep_original_sound to yes or no to control audio retention. Only MP4/MOV, 3–10 seconds, 720–2160 px, 24–60 fps, max 200 MB. Only one video is accepted.

callback_url
string

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.

Phản hồi

200 - application/json

Success

The response is of type object.