Skip to main content
POST
Використовуйте цей endpoint для сумісного з O1 робочого процесу Kling Omni, доступного через CometAPI, включно з генерацією text-to-video та генерацією з посиланням на зображення першого кадру.
Щоб переглянути повний довідник параметрів провайдера, дивіться документацію Kling Omni Video.

Виберіть режим введення

  • Text-to-video: надішліть prompt, mode, aspect_ratio і duration
  • Посилання на зображення першого кадру: додайте елементи image_list з image_url і type: first_frame, а потім посилайтеся на зображення в prompt як <<<image_1>>>
  • Вихід із водяним знаком: додайте watermark_info.enabled: true, коли вам потрібен URL відео з водяним знаком у відповіді запиту
  • Model ID: не вказуйте model_name, щоб використати значення маршруту за замовчуванням, або надішліть протестований model ID Omni Video, наприклад kling-video-o1 чи kling-v3-omni

Тривалість і співвідношення сторін

Kling Omni не надає точного поля size. Розглядайте aspect_ratio як запит форми кадру; запит text-to-video із 16:9 може бути відрендерений як full-HD 1920x1080.

Потік завдання

1

Створіть Omni-завдання

Надішліть запит і збережіть повернений task_id.
2

Опитуйте Omni-завдання

Продовжуйте з Отримати відео Kling Omni, доки завдання не завершиться.
3

Збережіть готове відео

Перемістіть повернений URL MP4 у власне сховище, якщо вам потрібен довготривалий доступ.

Авторизації

Authorization
string
header
обов'язково

Bearer token authentication. Use your CometAPI key.

Заголовки

Content-Type
string

Content type of the request body.

Тіло

application/json
prompt
string
обов'язково

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.

sound
enum<string>
за замовчуванням:off

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

Доступні опції:
on,
off
mode
enum<string>

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

Доступні опції:
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.

Доступні опції:
16:9,
9:16,
1:1
duration
enum<string>
за замовчуванням:5

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

Доступні опції:
5,
10
watermark_info
object

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to original 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.

Відповідь

200 - application/json

Success

code
integer
обов'язково

Response code. 0 means the task request was accepted.

message
string
обов'язково

Response message.

data
object
обов'язково
request_id
string

Request identifier returned by CometAPI when present.