Omni-Video

POST

/kling/v1/videos/omni-video

Создание задачи Omni-Video (текст в видео, изображение в видео, редактирование видео и др.).

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

Имя модели. Значения: kling-video-o1, kling-v3-omni

Текстовый промпт; может включать позитивные и негативные описания.
Промпт можно шаблонизировать под разные сценарии.
До 2500 символов.
Обязателен, если multi_shot = false.

object[]

Список референсных изображений (объект, сцена, стиль и т.д.) или первый/последний кадр видео.
Для первого/последнего кадра:
type: first_frame — первый кадр, end_frame — последний.
Только последний кадр не поддерживается; при end_frame нужен first_frame.
Первый/последний кадр несовместим с редактированием видео.

object[]

Референсное видео по URL.
Может быть видео-референсом (feature) или видео для редактирования (base, по умолчанию); можно сохранить оригинальный звук.
refer_type: feature — референс, base — для редактирования.
При base нельзя задавать первый/последний кадр.
keep_original_sound: yes — сохранить, no — убрать; действует и для feature.

Режим генерации.
Значения: std, pro.
std: стандартный режим, оптимальное соотношение цена/качество.
pro: режим высокого качества.

Соотношение сторон (ширина:высота).
Значения: 16:9, 9:16, 1:1.
Обязательно без первого кадра и без редактирования видео.

Длительность в секундах.
Значения: 3, 4, 5, 6, 7, 8, 9, 10.
Для текста/первого кадра — только 5 и 10.
При редактировании (refer_type base) длина совпадает с входным видео, поле игнорируется; биллинг по округлённой длительности входа.
kling-v3-omni: 3–15; при редактировании — те же правила.

object[]

Субъекты

Мультикадровое видео.
При true prompt не используется.
При false игнорируются shot_type и multi_prompt.

Способ разбивки на кадры.
Значение: customize.
Обязателен при multi_shot = true.

object[]