Kling V2.6 Motion Control

kling-v2-6-motion-control Kling V2.6 Motion Control предназначен для генерации видео с управлением движением на основе изображений и референсных видео.

Эндпоинты

POST /v1/queue/kling-v2-6-motion-control # Создать задачу

GET /v1/queue/kling-v2-6-motion-control/requests/{request_id}/status # Проверить статус

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v2-6-motion-control' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "image_url": "https://www.gstatic.com/webp/gallery/2.jpg",
  "video_url": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4",
  "character_orientation": "image",
  "element_list": [
    {
      "element_id": 829836802793406551
    }
  ],
  "mode": "std",
  "prompt": "A person dancing gracefully",
  "keep_original_sound": "yes",
  "watermark_info": {
    "enabled": false
  }
}'

image_url string required

Референсное изображение. Персонажи, фон и другие элементы в сгенерированном видео строятся на основе этого изображения

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

Пропорции персонажа должны как можно точнее соответствовать пропорциям референсного действия; избегайте управления персонажем по пояс с помощью действия в полный рост

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

Избегайте экстремальных положений, например стойки на руках или положения лежа; персонаж не должен занимать слишком малую часть кадра

Поддерживаются реалистичные и стилизованные персонажи, включая людей, антропоморфных животных, некоторых животных и персонажей с человекоподобными пропорциями конечностей

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

При использовании Base64 передавайте только закодированную строку без префиксов вроде data:image/png;base64,

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

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

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

Размеры: от 300px до 65536px

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

video_url string required

URL референсного видео. Движения персонажа в сгенерированном видео будут соответствовать референсному видео

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

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

Рекомендуется загружать видео с действием одного человека; если людей двое или больше, будет использован человек, занимающий наибольшую часть кадра

Рекомендуются действия реального человека; некоторые стилизованные персонажи с человекоподобными пропорциями конечностей также могут подойти

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

Избегайте слишком быстрых движений; более плавные действия дают лучший результат

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

Формат: .mp4, .mov

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

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

Требования к длительности:

Минимум: 3 секунды

Максимум зависит от character_orientation:

Если ориентация сопоставляется с персонажем в видео: максимум 30 секунд

Если ориентация сопоставляется с персонажем на изображении: максимум 10 секунд

Примечание: для сложных или быстрых действий результат может быть короче загруженного видео, так как модель извлекает только пригодные сегменты движения (минимум 3 секунды непрерывного подходящего действия). Списанные кредиты в таких случаях не возвращаются

character_orientation string required

Ориентация персонажа в сгенерированном видео; может сопоставляться с изображением или видео

image: сопоставлять ориентацию с персонажем на изображении; длительность референсного видео максимум 10 секунд

video: сопоставлять ориентацию с персонажем в видео; длительность референсного видео максимум 30 секунд

Варианты: image, video

element_list array

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

Передается в формате ключ:значение:

"element_list": [
  {
    "element_id": 829836802793406551
  }
]

При ссылке на субъект сгенерированное видео сейчас может учитывать только ориентацию персонажа из референсного видео

Сейчас поддерживается добавление только 1 субъекта

element_id long required

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

mode string required

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

std: стандартный режим, экономичный вариант

pro: экспертный режим (высокое качество), режим с более высоким качеством видео

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

prompt string

Текстовый промпт, может содержать положительные и негативные описания

Можно использовать для добавления элементов или реализации движения камеры в видео

Максимум 2500 символов

keep_original_sound string

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

yes: сохранить исходный звук

no: не сохранять исходный звук

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

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

watermark_info object

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

Задается параметром enabled:

"watermark_info": {
"enabled": boolean
}

callback_url string

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

external_task_id string

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

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

Значение должно быть уникальным в рамках одного пользователя

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

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

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