Kling V1 - Text to Video

kling-v1-t2v Kling V1 - Text to Video — базовая модель text-to-video, добавляющая естественное движение к статичным визуальным материалам.

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

kling-v1-t2v поддерживает управление камерой (camera_control) только когда mode имеет значение std, а duration равен 5 секундам

Эндпоинты

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

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v1-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",
  "negative_prompt": "blurry, low quality, distorted",
  "cfg_scale": 0.5,
  "mode": "std"
}'

prompt string required

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

duration string

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

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

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

aspect_ratio string

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

Варианты: 16:9, 9:16, 1:1

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

negative_prompt string

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

cfg_scale number

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

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

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

mode string

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

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

Режим pro: экспертный режим с более высоким качеством, выходное разрешение видео 1080P

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

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

camera_control object

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

type string

Предустановленный тип движения камеры

Тип simple: простое движение камеры; в config можно выбрать одно из шести движений

Тип down_back: камера опускается и отъезжает назад; параметр config не нужен

Тип forward_up: камера движется вперед и поднимается вверх; параметр config не нужен

Тип right_turn_forward: сначала поворот вправо, затем движение вперед; параметр config не нужен

Тип left_turn_forward: сначала поворот влево, затем движение вперед; параметр config не нужен

Варианты: simple, down_back, forward_up, right_turn_forward, left_turn_forward

config object

Содержит шесть полей для задания движения камеры или изменения в разных направлениях

Обязателен, когда type равен simple; для остальных типов не нужен

Выберите один из следующих 6 параметров: только один может быть ненулевым, остальные должны быть равны 0

horizontal number

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

Диапазон: -10 - 10, отрицательное значение перемещает влево, положительное вправо

vertical number

Вертикальное движение камеры вдоль оси y

Диапазон: -10 - 10, отрицательное значение перемещает вниз, положительное вверх

pan number

Горизонтальное панорамирование камеры, вращение вокруг оси y

Диапазон: -10 - 10, отрицательное значение поворачивает влево, положительное вправо

tilt number

Вертикальный наклон камеры, вращение вокруг оси x

Диапазон: -10 - 10, отрицательное значение наклоняет вниз, положительное вверх

roll number

Крен камеры, вращение вокруг оси z

Диапазон: -10 - 10, отрицательное значение вращает против часовой стрелки, положительное по часовой стрелке

zoom number

Зум, управляет изменением фокусного расстояния камеры и дальностью поля зрения

Диапазон: -10 - 10, отрицательное значение приближает, положительное отдаляет

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

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