Kling V3 Turbo - Text to Video

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

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v3-turbo-t2v' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A cinematic drone shot over a misty mountain range at sunrise",
  "settings": {
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "duration": 5
  },
  "options": {
    "watermark_info": {
      "enabled": false
    }
  }
}'

prompt string required

Текстовый промпт. Может содержать положительное и отрицательное описание.

Длина содержимого не должна превышать 3072 символа. Рекомендуется не более 2500 символов.

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

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

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

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

settings object

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

resolution string

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

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

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

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

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

aspect_ratio string

Соотношение сторон создаваемого видео (ширина:высота).

Перечисление: 16:9, 9:16, 1:1.

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

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

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