Kling V3 Omni Video

kling-v3-omni-video Kling V3 Omni Video — мультимодальный интерфейс генерации видео, поддерживающий текст, изображения, видео и пользовательские элементы в качестве мультимодальных входных данных.

Примечание к API

При использовании видео-референса длительность входного видео должна быть 3s-15.5s

Эндпоинты

POST /v1/queue/kling-v3-omni-video # Создать задачу

GET /v1/queue/kling-v3-omni-video/requests/{request_id}/status # Проверить статус

GET /v1/queue/kling-v3-omni-video/requests/{request_id}/response # Получить результат

PUT /v1/queue/kling-v3-omni-video/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-omni-video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
  "mode": "pro",
  "aspect_ratio": "16:9",
  "duration": "5"
}'

multi_shot boolean

Генерировать ли видео из нескольких шотов

Если параметр равен true и shot_type равен customize, параметр prompt не используется

Если параметр равен false, параметры shot_type и multi_prompt не используются

По умолчанию: false

shot_type string

Тип шота

Если multi_shot равен true, этот параметр обязателен

Варианты: customize, intelligence

prompt string

Промпт для генерации видео, может содержать позитивные и негативные описания. Промпт можно шаблонизировать под разные задачи генерации видео

Модель Video O3 может использовать в промпте субъекты, изображения, видео и другой контент:

Используйте формат <<<>>>, чтобы указать субъект, изображение или видео, например <<<element_1>>>, <<<image_1>>>, <<<video_1>>>

Не более 2500 символов

Параметр не должен быть пустым, если multi_shot равен false, либо если multi_shot равен true и shot_type равен intelligence

multi_prompt array

Информация по нескольким шотам, например промпты и длительность

Последовательность шотов, соответствующие промпты и длительность задаются параметрами index, prompt и duration:

- Поддерживается от 1 до 6 шотов

- Максимальная длина содержимого каждого шота не должна превышать 512 символов

- Длительность каждого шота не должна превышать общую длительность текущей задачи и должна быть не меньше 1

- Сумма длительностей всех шотов должна равняться общей длительности текущей задачи

Пример:

"multi_prompt": [
  {
    "index": 1,
    "prompt": "string",
    "duration": "5"
  },
  {
    "index": 2,
    "prompt": "string",
    "duration": "5"
  }
]

Если multi_shot равен true и shot_type равен customize, этот параметр не может быть пустым

image_list array

Список референсных изображений, включая изображения для референса субъекта, сцены и стиля. Также может использоваться как первый или последний кадр для генерации видео

При использовании как первого или последнего кадра:

- Используйте параметр type, чтобы указать, является ли изображение первым или последним кадром: first_frame для первого кадра, end_frame для последнего кадра

- Сейчас нельзя указать только последний кадр; если задан последний кадр, первый кадр также обязателен

- При генерации видео с первым/последним кадром функция редактирования видео недоступна

Поддерживает изображение в кодировке Base64 или URL изображения (убедитесь, что URL доступен)

Требования к изображению:

Формат: .jpg, .jpeg, .png

Размер файла: не более 10MB

Размеры: ширина и высота не меньше 300px

Соотношение сторон: от 1:2.5 до 2.5:1

Ограничения по количеству:

При наличии референсного видео: количество изображений + количество субъектов ≤ 4

Без референсного видео: количество изображений + количество субъектов ≤ 7

Если количество изображений больше 2, настройка последнего кадра не поддерживается

Значение параметра image_url не может быть пустым

image_url string

URL изображения или данные Base64

type string

Тип изображения

Варианты: first_frame, end_frame

element_list array

Список референсов субъекта, настраивается по ID субъекта из библиотеки субъектов

Создание субъекта описано здесь: kling_custom_elements

Пример:

"element_list": [
  {
    "element_id": 123456789
  },
  {
    "element_id": 987654321
  }
]

Ограничения по количеству:

При генерации видео по первому кадру или по первому и последнему кадру поддерживается не более 3 субъектов

При наличии референсного видео: количество изображений + количество субъектов ≤ 4, видео-субъекты не поддерживаются

Без референсного видео: количество изображений + количество субъектов ≤ 7

Субъекты делятся на пользовательские видео-субъекты (видео-персонажи) и пользовательские субъекты для изображений; области применения различаются, учитывайте это

element_id long

ID субъекта из библиотеки субъектов

video_list array

Референсное видео, передается через URL. Может использоваться как видео для референса характеристик или как видео для редактирования; по умолчанию используется как видео для редактирования. Можно выбрать, сохранять ли исходный звук

- Используйте refer_type, чтобы различать тип референсного видео: feature для видео-референса характеристик, base для видео для редактирования

- Если референсное видео используется как видео для редактирования, нельзя задавать первый/последний кадр

- Используйте keep_original_sound, чтобы выбрать, сохранять ли исходный звук: yes — сохранить, no — не сохранять; параметр также действует для видео-референса характеристик (feature)

Если задано референсное видео, значение параметра sound может быть только off

Пример:

"video_list": [
  {
    "video_url": "https://example.com/video.mp4",
    "refer_type": "base",
    "keep_original_sound": "yes"
  }
]

Требования к видео:

Формат: только MP4 / MOV

Длительность: 3s - 15.5s

Ширина и высота: 700px - 4553px, площадь не больше 8294400

Частота кадров: 24fps - 60fps

Максимум 1 видео, размер не больше 200MB

Соотношение сторон: от 1:2.5 до 2.5:1

Значение параметра video_url не может быть пустым

video_url string required

URL видео, поддерживаются форматы MP4/MOV

refer_type string

Тип референсного видео

Варианты: feature, base

По умолчанию: base

keep_original_sound string

Сохранять ли исходный звук

Варианты: yes, no

sound string

Генерировать ли звук при создании видео

Варианты: on, off

По умолчанию: off

mode string

Режим генерации видео

std: стандартный режим, базовый режим с генерацией видео 720P, выгодный по стоимости

pro: профессиональный режим высокого качества, генерирует видео 1080P с более высоким качеством

4k: режим 4K, выходное разрешение 4K

Варианты: std, pro, 4k

По умолчанию: pro

aspect_ratio string

Соотношение сторон видео (ширина:высота)

Обязателен, если не используется референс первого кадра или функция редактирования видео

Варианты: 16:9, 9:16, 1:1

duration string

Длительность видео в секундах

При использовании функции редактирования видео (refer_type: base) длительность результата совпадает с длительностью входного видео, этот параметр не действует; тарификация выполняется по длительности входного видео с округлением до ближайшей секунды

Варианты: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

По умолчанию: 5

watermark_info object

Генерировать ли одновременно результат с водяным знаком

Пример:

"watermark_info": {
  "enabled": false
}

Пользовательские водяные знаки сейчас не поддерживаются

callback_url string

Адрес обратного вызова для уведомлений о результате этой задачи. Если он задан, сервер будет отправлять уведомления при изменении статуса задачи

external_task_id string

Пользовательский ID задачи

Пользовательский ID задачи. Он не перезаписывает системный ID, но позволяет искать задачу по этому ID

Убедитесь, что значение уникально в рамках одного пользователя

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-omni-video/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-omni-video/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-v3-omni-video/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	ID задачи, используется для последующих запросов.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Дальнейшие действия