Kling V2.6 - Image to Video

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

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

kling-v2-6-i2v поддерживает видео со звуком только когда mode равен pro, а sound равен on.
kling-v2-6-i2v поддерживает одновременное использование параметров image и image_tail только когда mode равен pro.
kling-v2-6-i2v генерирует видео без звука, когда одновременно используются параметры image и image_tail (режим первого и последнего кадра).
kling-v2-6-i2v сейчас не поддерживает ввод только хвостового кадра с одним параметром image_tail.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v2-6-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",
  "sound": "on",
  "cfg_scale": 0.5,
  "mode": "pro"
}'

image string required

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

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

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

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

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

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

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

image_tail string

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

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

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

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

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

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

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

Примечание: Поддерживается только при mode = pro для режима первого и последнего кадра; видео, созданные по первому и последнему кадру, не содержат звука

prompt string

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

Используйте <<<voice_1>>>, чтобы указать тембр голоса; номер соответствует порядку голосов, указанных в параметре voice_list

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

Чем проще синтаксическая структура, тем лучше. Например: мужчина <<<voice_1>>> говорит: "Здравствуйте"

negative_prompt string

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

mode string

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

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

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

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

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

sound string

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

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

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

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

voice_list array

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

Одна задача генерации видео может ссылаться максимум на 2 тембра голоса

Если параметр voice_list не пустой и в параметре prompt указан ID голоса, задача генерации видео тарифицируется как задача с указанным тембром голоса

duration string

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

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

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

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

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