Kling V3 - Image to Video

kling-v3-i2v Kling V3 - Image to Video предлагает продвинутые многообъектные видеоэффекты с повышенной точностью отслеживания и общей стабильностью.

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

image и image_tail поддерживают передачу изображения как Base64 и как доступный URL изображения. При использовании Base64 передавайте только закодированную строку и не добавляйте префиксы вроде data:image/png;base64,.
Требования к изображению: формат .jpg, .jpeg или .png; размер не более 10MB; ширина и высота не меньше 300px; соотношение сторон от 1:2.5 до 2.5:1.
Параметр image обязателен; ввод только с хвостовым кадром через image_tail не поддерживается.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-i2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "image": "https://www.gstatic.com/webp/gallery/4.jpg",
  "image_tail": "https://www.gstatic.com/webp/gallery/5.jpg",
  "prompt": "A cinematic drone shot over a misty mountain range at sunrise",
  "negative_prompt": "blurry, low quality, distorted",
  "sound": "on",
  "cfg_scale": 0.5,
  "mode": "4k",
  "watermark_info": {
    "enabled": false
  }
}'

image string required

Референсное изображение

image_tail string

Референсное изображение для управления конечным кадром

multi_shot boolean

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

Когда этот параметр равен true, параметр prompt не применяется для режима customize

Когда этот параметр равен false, параметры shot_type и multi_prompt не применяются

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

shot_type string

Тип шота

Когда параметр multi_shot равен true, этот параметр обязателен

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

prompt string

Позитивный текстовый промпт

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

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

Для указания голоса можно использовать <<<voice_1>>>. Номер соответствует порядку голосов в параметре voice_list

В одной задаче генерации видео можно указать не более 2 голосов. При указании голоса параметр sound должен быть равен on

multi_prompt array

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

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

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

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

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

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

Формат key:value:

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

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

negative_prompt string

Негативный текстовый промпт

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

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

element_list array

Список референсов субъекта

Настраивается на основе ID субъекта из библиотеки субъектов, формат key:value:

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

"element_list": [
  {
    "element_id": long
  },
  {
    "element_id": long
  }
]

Поддерживается не более 3 референсных субъектов

element_list и voice_list взаимоисключающие и не могут использоваться вместе

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

voice_list array

Список голосов, используемых при генерации видео

В одной задаче можно указать не более 2 голосов

element_list и voice_list взаимоисключающие и не могут использоваться вместе

Формат key:value:

"voice_list": [
  {
    "voice_id": "string"
  },
  {
    "voice_id": "string"
  }
]

cfg_scale float

Параметр управления соответствием промпту

Диапазон: [0, 1]

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

sound string

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

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

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

mode string

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

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

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

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

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

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

duration string

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

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

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

watermark_info object

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

Задается параметром enabled, формат key:value:

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

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