Skip to main content
POST

Аутентификация

string
обязательно
Все запросы требуют аутентификации по Bearer TokenПолучение API-ключа:Перейдите на страницу управления API-ключами, чтобы получить свой API-ключДобавьте следующий заголовок в каждый запрос:

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

string
обязательно
Название модели: kling-v3-motion-control или kling-v2-6-motion-control
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации видео.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
Текстовое описание желаемого движения, перемещения камеры и стиляНеобязательный, но рекомендуемый параметр — более конкретные описания дают более стабильные результатыПример: "The character dances following the reference video, smooth motion, realistic style"
string
обязательно
URL референсного изображенияДолжен быть публично доступной ссылкой
string
обязательно
URL референсного видеоДолжен быть публично доступной прямой ссылкой; рекомендуется mp4/mov, размер до 100 МБ
Сервер определяет фактическую длительность по video_url. Минимум — 3 секунды; максимум зависит от значения character_orientation.
string
по умолчанию:"yes"
Сохранять ли оригинальную аудиодорожку из референсного видеоВарианты:
  • yes: сохранять оригинальное аудио (по умолчанию)
  • no: не сохранять оригинальное аудио
string
обязательно
Управление ориентацией персонажаВарианты:
  • image: использовать ориентацию персонажа из референсного изображения (длительность референсного видео: 3~10s)
  • video: использовать ориентацию персонажа из референсного видео (длительность референсного видео: 3~30s)
string
обязательно
Режим генерацииВарианты:
  • std: стандартный режим (баланс скорости и качества)
  • pro: режим высокого качества (более высокая задержка)
object
Объект управления водяным знаком (необязательно)

Правила длительности

Длительность для тарификации определяется фактической длительностью, считываемой сервером из video_url, а не клиентской оценкой.

Ответ

integer
Код состояния ответа, 200 при успехе
array
Массив данных ответа

Примеры

Пример 1: ориентация по изображению (в пределах 10 с)

Пример 2: ориентация по видео (в пределах 30 с)