Kling 4.0 API

Полный справочник API моделей генерации видео Kling 4.0 от Kuaishou.

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

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

Краткое сравнение

Поддерживаемые соотношения сторон

Text-to-Video, Image-to-Video, Reference-to-Video и Video Edit поддерживают:

16:9, 9:16, 1:1, 21:9

Значение по умолчанию — 16:9. Video Extend не поддерживает параметр aspect_ratio; результат сохраняет соотношение сторон исходного видео.

Варианты разрешения

Для всех пяти моделей обязательны resolution и duration. Явно указывайте resolution, даже несмотря на значение по умолчанию 720p. У duration нет значения по умолчанию.

Kling 4.0 Text to Video

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

POST /api/v1/video/task

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

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

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

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

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-v4.0-text-to-video',
    prompt: 'A drone flying over a mountain range at sunrise, smooth forward camera movement',
    resolution: '720p',
    duration: 5,
    aspect_ratio: '16:9'
  })
});

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

Kling 4.0 Image to Video

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

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

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

Если указаны и image_url, и image_end_url, массив key_frames может содержать не более 8 изображений. Промежуточные кадры используются в порядке массива; их временное расположение определяет модель.

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

javascriptКопировать
{
  model_name: 'kling-v4.0-image-to-video',
  prompt: 'Camera slowly pulls back from the character to reveal the surrounding mountain landscape',
  image_url: 'https://example.com/start-frame.jpg',
  image_end_url: 'https://example.com/end-frame.jpg',
  key_frames: [
    'https://example.com/middle-frame-1.jpg',
    'https://example.com/middle-frame-2.jpg'
  ],
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Reference to Video

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

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

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

Референсные изображения, видео и аудио необязательны. Можно указать любой один тип медиафайлов, сочетать несколько типов или не указывать ни один из трёх.

Длительность результата duration задаётся независимо в диапазоне 3-30 секунд и не учитывается в ограничении суммарной длительности референсных видео.

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

javascriptКопировать
{
  model_name: 'kling-v4.0-reference-to-video',
  prompt: 'Use the character from the reference image, follow the camera movement in the reference video, and use the reference audio for voice guidance',
  images: ['https://example.com/character-reference.jpg'],
  videos: ['https://example.com/motion-reference.mp4'],
  audios: ['https://example.com/voice-reference.mp3'],
  keep_original_sound: false,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Edit

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

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

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

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

javascriptКопировать
{
  model_name: 'kling-v4.0-video-edit',
  prompt: 'Replace the background with warm sunset colors while preserving the subject and camera movement',
  video_url: 'https://example.com/source.mp4',
  images: ['https://example.com/sunset-reference.jpg'],
  keep_original_sound: true,
  resolution: '720p',
  duration: 8,
  aspect_ratio: '16:9'
}

Kling 4.0 Video Extend

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

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

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

Не передавайте aspect_ratio; результат сохраняет соотношение сторон исходного видео. Результат содержит полное видео, включая исходное видео и добавленный сегмент. Его общая длительность равна длительности исходного видео плюс duration.

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

javascriptКопировать
{
  model_name: 'kling-v4.0-video-extend',
  prompt: 'Continue the camera movement forward through the valley as the sun rises above the mountains',
  video_url: 'https://example.com/source.mp4',
  image_end_url: 'https://example.com/target-end-frame.jpg',
  resolution: '720p',
  duration: 5
}

Правила тарификации

Для Text-to-Video и Image-to-Video стоимость рассчитывается по разрешению результата и длительности сгенерированного видео. Для Video Extend стоимость рассчитывается по разрешению и длительности добавленного сегмента, а не по полной длительности возвращаемого видео.

Для запросов Reference-to-Video с референсными видео и запросов Video Edit учитывается длительность как входного, так и выходного видео при выбранном разрешении. Минимальная оплачиваемая длительность входного видео — 3 секунды, максимальная — 30 секунд. Если референсных видео несколько, эти границы применяются к их суммарной длительности, а не к каждому видео отдельно. Границы оплачиваемой длительности не определяют ограничения загрузки.

Без референсных видео для Reference-to-Video действуют те же правила тарификации, что и для Text-to-Video, независимо от наличия референсных изображений или аудио. В запросах с входным видео поддерживаемые референсные изображения, референсное аудио и keep_original_sound не оплачиваются отдельно.

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

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

Все модели возвращают 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. Обязательные параметры: Всегда указывайте resolution и duration, в том числе при использовании разрешения по умолчанию 720p
2. Количество кадров: Общее количество первого, конечного и промежуточных кадров не должно превышать 10
3. Референсные медиафайлы: Соблюдайте указанные в документации ограничения на количество и длительность референсных медиафайлов
4. Исходный звук: Используйте keep_original_sound только для Reference-to-Video или Video Edit
5. Продление видео: Укажите в duration добавляемую длительность и не передавайте aspect_ratio