Kling V2.1 - Image to Video

kling-v2-1-i2v Kling V2.1 - Image to Video — продвинутая модель image-to-video с более точным управлением движением и повышенной стабильностью вывода.

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

kling-v2-1-i2v не поддерживает ввод только конечного кадра.
kling-v2-1-i2v поддерживает одновременное использование параметров image и image_tail только когда mode равен pro.
kling-v2-1-i2v в режиме std генерирует видео с разрешением 720p и частотой 24fps.
kling-v2-1-i2v в режиме pro генерирует видео с разрешением 1080p и частотой 24fps.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v2-1-i2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "image": "https://www.gstatic.com/webp/gallery/1.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

prompt string

Промпт для генерации видео (необязательно), максимум 2500 символов

duration string

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

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

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

mode string

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

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

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

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

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

negative_prompt string

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

image_tail string

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

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

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

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

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

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

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

watermark_info object

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

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

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