Kling Video O1

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

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-video-o1' \
  --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"
}'

prompt string required

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

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

image_list array

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

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

Примечания:

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

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

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

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

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

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

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

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

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

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

С референсным видео: количество изображений + количество элементов ≤ 4

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

image_url string

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

image string

URL изображения или данные Base64 (совместимое поле)

type string

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

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

video_list array

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

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

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

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

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

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

Длительность: 3-10 секунд

Размеры: от 720px до 2160px

Частота кадров: 24-60fps, выход будет 24fps

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

video_url string required

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

refer_type string

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

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

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

keep_original_sound string

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

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

element_list array

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

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

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

С референсным видео: количество изображений + количество элементов ≤ 4

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

element_id integer

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

mode string

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

std: стандартный режим с хорошим соотношением цены и качества

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

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

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

aspect_ratio string

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

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

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

duration string

Длительность видео в секундах, Omni поддерживает 3-10 секунд

Для генерации по тексту или по первому кадру поддерживаются только 5 и 10 секунд

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

Варианты: 3, 4, 5, 6, 7, 8, 9, 10

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

watermark_info array

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

Задается параметром enabled, конкретный формат ниже:

"watermark_info": {
"enabled": boolean
}

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

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-video-o1/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-video-o1/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-video-o1/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	Текущая позиция в очереди.

Следующие операции