Kling V3 Turbo - Image to Video

kling-v3-turbo-i2v Kling V3 Turbo поддерживает image-to-video генерацию с быстрым синтезом движения и настраиваемым выводом 720P или 1080P.

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

kling-v3-turbo-i2v поддерживает только первый кадр. Первый+последний кадр и только последний кадр не поддерживаются.

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-turbo-i2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "contents": [
    {
      "type": "prompt",
      "text": "A girl sat on the train, looking out the window with a melancholic expression, her head swaying with the train."
    },
    {
      "type": "first_frame",
      "url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-tob-release_note/image_25.png"
    }
  ],
  "settings": {
    "resolution": "1080p",
    "duration": 10
  },
  "options": {
    "external_task_id": "",
    "watermark_info": {
      "enabled": true
    }
  }
}'

contents array required

Набор референсных материалов, например промпт и изображение.

Поля, относящиеся к одному материалу, размещайте в одном объекте.

Пример формата: [{ "type": "prompt", "text": "string" }, { "type": "first_frame", "url": "https://your-cdn.com/start-frame.jpg" }]

type string required

Тип материала. Поддерживаются промпт и изображение первого кадра.

Перечисление: prompt, first_frame.

prompt: идентификатор материала промпта.

first_frame: идентификатор материала первого кадра.

text string

Текстовый промпт при type=prompt.

Промпт может содержать положительное и отрицательное описание. Длина содержимого не должна превышать 2500 символов.

Многоракурсное видео можно создать в фиксированном формате: shot n, m, words; shot n, m, words;, разделяя части полуширинными знаками.

n: номер кадра. Поддерживается максимум 6 кадров и минимум 1 кадр.

m: длительность кадра. Длительность каждого кадра должна быть не меньше 1, а сумма длительностей всех кадров должна равняться общей длительности создаваемого видео.

words: промпт кадра. Максимальная длина — 512.

url string

Референс первого кадра, используется при type=first_frame.

Материал можно передать через URL или Base64.

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

Размер файла изображения не должен превышать 50MB.

Ширина и высота изображения должны быть не менее 300px, а соотношение сторон должно быть в диапазоне от 1:2.5 до 2.5:1.

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

settings object

Параметры выходной конфигурации, например разрешение и длительность.

resolution string

Четкость создаваемого видео.

Перечисление: 720p, 1080p.

720p: выводит видео с четкостью 720P.

1080p: выводит видео с четкостью 1080P.

По умолчанию: 720p.

duration int

Длительность создаваемого видео в секундах.

Перечисление: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15.

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

options object

Общие настройки, например URL обратного вызова и вывод с водяным знаком.

callback_url string

URL обратного вызова для уведомления о результате этой задачи.

Если параметр задан, сервер будет уведомлять этот адрес при изменении статуса задачи.

external_task_id string

Пользовательский ID задачи.

Переданное значение не перезаписывает системный ID задачи, но поддерживает поиск задачи по этому ID.

Для одного пользователя значение должно быть уникальным.

watermark_info object

Нужно ли также сгенерировать результат с водяным знаком.

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

enabled boolean

true — генерировать результат с водяным знаком, false — не генерировать.

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

Параметры ответа

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

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