Kling V1.5 - Image to Video

kling-v1-5-i2v Kling V1.5 - Image to Video создает видео из изображений с помощью ИИ.

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

Необходимо передать хотя бы один из параметров image и image_tail; они не могут быть пустыми одновременно.
kling-v1-5-i2v поддерживает первый и последний кадр или только последний кадр (image + image_tail или только image_tail) только когда mode равен pro
kling-v1-5-i2v поддерживает motion brush (dynamic_masks/static_mask) только когда mode равен pro и duration равен 5 секундам
kling-v1-5-i2v поддерживает управление камерой (camera_control, только simple) только когда mode равен pro и duration равен 5 секундам

Эндпоинты

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

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

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

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

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

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

image string required

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

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

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

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

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

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

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

Необходимо передать хотя бы один из параметров image и image_tail; они не могут быть пустыми одновременно.

Параметры image + image_tail, параметры dynamic_masks/static_mask и параметр camera_control являются взаимоисключающими

image_tail string required

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

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

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

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

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

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

Необходимо передать хотя бы один из параметров image и image_tail; они не могут быть пустыми одновременно.

Параметры image + image_tail, параметры dynamic_masks/static_mask и параметр camera_control являются взаимоисключающими

prompt string

Положительный текстовый промпт, максимум 2500 символов

duration string

Длительность видео

Варианты: 5, 10

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

cfg_scale number

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

Диапазон: 0 - 1

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

negative_prompt string

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

mode string

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

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

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

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

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

static_mask string

Область статической кисти (изображение маски, нарисованное пользователем через инструмент motion brush)

Возможность motion brush включает два типа: динамическую кисть dynamic_masks и статическую кисть static_mask

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

Поддерживаемые форматы изображения: .jpg, .jpeg, .png

Соотношение сторон изображения должно совпадать с входным изображением (то есть с полем image), иначе задача завершится ошибкой

static_mask и dynamic_masks.mask должны иметь одинаковое разрешение, иначе задача завершится ошибкой

dynamic_masks array

Список настроек динамической кисти

Можно настроить несколько групп, максимум 6; каждая группа содержит область маски и последовательность trajectories

mask string

Область маски динамической кисти (изображение маски, нарисованное пользователем через инструмент motion brush)

Поддерживаемые форматы изображения: .jpg, .jpeg, .png

static_mask и dynamic_masks.mask должны иметь одинаковое разрешение, иначе задача завершится ошибкой

trajectories array

Последовательность координат траектории движения

Для видео длительностью 5 секунд длина траектории не должна превышать 77, то есть количество координат должно быть в диапазоне [2, 77]

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

Примечание 1: чем больше координатных точек, тем точнее описание траектории. Если указаны только 2 точки, они будут соединены прямой линией

Примечание 2: направление траектории следует порядку ввода. Первая координата является начальной точкой, последующие координаты последовательно соединяются и формируют траекторию движения

x integer

Координата x точки траектории (пиксельная координата с левым нижним углом изображения в качестве начала координат)

y integer

Координата y точки траектории (пиксельная координата с левым нижним углом изображения в качестве начала координат)

camera_control object

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

Параметры image + image_tail, параметры dynamic_masks/static_mask и параметр camera_control являются взаимоисключающими

type string

Предустановленный тип движения камеры

Варианты: simple

simple: простое движение камеры, выберите один из шести вариантов в config

config object

Содержит шесть полей для задания движения или изменения камеры в разных направлениях

Обязательно, когда тип движения камеры задан как simple

Выберите один из шести параметров ниже: только один параметр может быть ненулевым, остальные должны быть равны 0

horizontal number

Горизонтальное движение, управляет перемещением камеры по горизонтали (смещение вдоль оси x)

Диапазон: [-10, 10]

Отрицательные значения означают смещение влево, положительные значения означают смещение вправо

vertical number

Вертикальное движение, управляет перемещением камеры по вертикали (смещение вдоль оси y)

Диапазон: [-10, 10]

Отрицательные значения означают смещение вниз, положительные значения означают смещение вверх

pan number

Горизонтальная панорама, управляет поворотом камеры в горизонтальной плоскости (вращение вокруг оси y)

Диапазон: [-10, 10]

Отрицательные значения означают поворот влево вокруг оси y, положительные значения означают поворот вправо

tilt number

Вертикальный наклон, управляет поворотом камеры в вертикальной плоскости (вращение вокруг оси x)

Диапазон: [-10, 10]

Отрицательные значения означают поворот вниз вокруг оси x, положительные значения означают поворот вверх

roll number

Крен, управляет величиной крена камеры (вращение вокруг оси z)

Диапазон: [-10, 10]

Отрицательные значения означают вращение против часовой стрелки вокруг оси z, положительные значения означают вращение по часовой стрелке

zoom number

Зум, управляет изменением фокусного расстояния камеры и влияет на дальность поля зрения

Диапазон: [-10, 10]

Отрицательные значения означают большее фокусное расстояние и меньший угол обзора, положительные значения означают меньшее фокусное расстояние и больший угол обзора

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

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