Kling V1 - Image to Video

kling-v1-i2v Kling V1 - Image to Video генерирует видео из изображений с более сильной временной связностью и согласованностью для длинных или сложных сцен.

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

kling-v1-i2v не поддерживает ввод только конечного кадра (только image_tail)
kling-v1-i2v поддерживает первый и последний кадр (image + image_tail) только когда duration равен 5 секундам
kling-v1-i2v поддерживает motion brush (dynamic_masks/static_mask) только когда duration равен 5 секундам

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v1-i2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "image": "https://www.gstatic.com/webp/gallery/2.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 и параметры dynamic_masks/static_mask взаимоисключающие, их нельзя использовать вместе

image_tail string

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

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

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

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

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

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

prompt string

Промпт для генерации видео, длина от 1 до 2500 символов

mode string

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

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

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

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

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

duration string

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

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

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

cfg_scale number

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

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

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

negative_prompt string

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

static_mask string

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

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

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

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

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

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

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

Примечание: поддерживается только при длительности 5 секунд

dynamic_masks array

Список конфигураций динамической кисти. Можно настроить несколько групп (максимум 6); каждая содержит область маски mask и последовательность траектории движения trajectories

Примечание: поддерживается только при длительности 5 секунд

mask string

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

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

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

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

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

trajectories array

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

Для видео длительностью 5 секунд максимальная длина траектории — 77, диапазон количества координат: [2, 77]

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

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

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

x int

Координата x точки траектории в пикселях в двумерной системе координат с началом в левом нижнем углу входного изображения

y int

Координата y точки траектории в пикселях в двумерной системе координат с началом в левом нижнем углу входного изображения

watermark_info object

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

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

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

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

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