API Kling 3.0 Motion Control

Полный справочник API для генерации видео с помощью Kling 3.0 Motion Control от Kuaishou.

Варианты модели

Этот API поддерживает один вариант модели:

Kling 3.0 Motion Control

Конечная точка

POST /api/v1/video/task

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

Обязательные

Необязательные

Длительность выходного видео соответствует длительности исходного. Параметр duration не поддерживается. Соотношение сторон выходного видео определяется входными медиафайлами; параметр aspect_ratio не поддерживается. Поставщик модели не указал, какой из входных файлов определяет соотношение сторон выходного видео и по какому именно правилу оно выбирается.

Стоимость рассчитывается на основе длительности исходного видео, округлённой до ближайшей целой секунды, и выбранного разрешения выходного видео. Например, 5,4 секунды тарифицируются как 5 секунд, а 5,5 секунды — как 6 секунд.

Пример запроса

Замените URL медиафайлов из примера ссылками на собственные файлы, соответствующие указанным выше требованиям.

javascriptКопировать
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'kling-3.0-motion-control',
    prompt: 'Animate the character in the reference image using the dance movements from the reference video',
    images: ['https://example.com/character.jpg'],
    videos: ['https://example.com/dance-reference.mp4'],
    character_orientation: 'video',
    resolution: '720p',
    keep_original_sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Формат ответа

Первоначальный ответ

Возвращает task_id для периодического опроса:

jsonКопировать
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Выполняйте периодический опрос с помощью GET /api/v1/video/{task_id}, чтобы проверять статус и получить сгенерированное видео.

Значения статуса

• submitted: Задача принята и ожидает обработки
• processing: Выполняется генерация видео
• succeed: Генерация видео завершена
• failed: Не удалось сгенерировать видео

Рекомендации {#}

1. Референсные медиафайлы: Передайте ровно одно изображение и одно видео, проверив перед отправкой их форматы, размеры файлов и размеры в пикселях
2. Ориентация: Повторно проверяйте длительность референсного видео при переключении character_orientation, особенно при выборе "image"
3. Исходный звук: Установите keep_original_sound в false, чтобы отключить сохранение исходного звука референсного видео; если параметр не указан, звук сохраняется