Перейти к основному содержанию
POST
/
v3
/
async
/
kling-v3.0-motion-control
Управление движением Kling V3.0
curl --request POST \
  --url https://api.highwayapi.ai/v3/async/kling-v3.0-motion-control \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "image": "<string>",
  "video": "<string>",
  "prompt": "<string>",
  "model_name": "<string>",
  "negative_prompt": "<string>",
  "keep_original_sound": true,
  "character_orientation": "<string>"
}
'
{
  "task_id": "<string>"
}
Инструмент управления движением Kling V3.0 извлекает траектории движения из референсного видео и применяет их к референсному изображению для генерации видео, сохраняя согласованность объекта. Поддерживаются стандартный и профессиональный режимы; тарификация посекундная.
Это асинхронный API, который возвращает только task_id асинхронной задачи. Используйте этот task_id для запроса API получения результата задачи, чтобы получить результат генерации.

Заголовки запроса

Content-Type
string
обязательно
Перечисляемое значение: application/json
Authorization
string
обязательно
Формат аутентификации Bearer: Bearer {{API 密钥}}.

Тело запроса

image
string
обязательно
URL референсного изображения или изображение в кодировке base64; поддерживаются .jpg, .jpeg, .png. Размер файла изображения не должен превышать 10MB; ширина и высота должны быть >= 300px; соотношение сторон должно быть в диапазоне от 1:2.5 до 2.5:1.
video
string
обязательно
URL референсного видео движения; поддерживаются .mp4, .mov. Размер видеофайла не должен превышать 10MB; ширина и высота должны быть >= 300px; длительность — 3–30 секунд.
prompt
string
Позитивный промпт с описанием сцены, стиля, освещения и т. д.; длина не более 2500 символов.Ограничение длины: 0 - 2500
model_name
string
по умолчанию:"kling-v3-0-std"
обязательно
Название модели. kling-v3-0-std: стандартный режим, высокая экономичность; kling-v3-0-pro: профессиональный режим, более высокое качество видео.Допустимые значения: kling-v3-0-std, kling-v3-0-pro
negative_prompt
string
Негативный промпт, описывающий элементы, которых следует избегать в сгенерированном видео; длина не более 2500 символов.Ограничение длины: 0 - 2500
keep_original_sound
boolean
по умолчанию:true
Определяет, сохранять ли исходный звук референсного видео.
character_orientation
string
обязательно
Режим выходных кадров:
  • image: приоритет отдается позе и композиции персонажа на референсном изображении; движение переносится на персонажа изображения (выход — 5 секунд)
  • video: приоритет отдается позе и композиции персонажа в референсном видео; движения из видео применяются к персонажу изображения (длительность выхода совпадает с референсным видео, максимум 30 секунд)
Допустимые значения: image, video

Информация об ответе

task_id
string
обязательно
Используйте task_id для запроса API получения результата задачи, чтобы получить сгенерированный вывод.