Kling Video API

Вызов kling-3.0-turbo с оплатой по разрешению (720P / 1080P / 2K / 4K), а также правила длительности, соотношения сторон, референсных изображений и видео, первого и последнего кадра и звука.

На этой странице описан вызов видеомодели Kling от Kuaishou — kling-3.0-turbo. Как и другие видеомодели, она создаётся через POST /v1/videos и опрашивается через GET /v1/videos/{id}; аутентификация, загрузка материалов, статусы опроса, скачивание результатов и обработка ошибок описаны в полной спецификации Video API. Здесь приведены только поля и правила, специфичные для Kling.

Обновлено 2026-10-10. Модели Kling поддерживают только опрос: не указывайте callback_url при создании, иначе запрос будет отклонён.

Модели

Модель	Доступные разрешения	Длительность	Соотношение сторон	Лимит изображений / видео / аудио
`kling-3.0-turbo`	`720p` (по умолчанию), `1080p`, `2k`, `4k`	4–15 с, по умолчанию 5 с	`16:9` `9:16` `1:1`, по умолчанию `16:9`	30 (включая первый и последний кадр) / 10 / 0

Выходное разрешение выбирается полем resolution, и тарификация идёт по выбранному уровню; регистр не важен (4k и 4K равнозначны). Без него используется минимальный уровень 720p. Неподдерживаемый уровень вернёт 400 без автоматического понижения.

Общие правила

Длительность: целое число секунд от 4 до 15 в duration (или строкой в seconds); по умолчанию 5 секунд.
Соотношение сторон: ratio (или aspect_ratio) принимает 16:9, 9:16, 1:1.
Промпт: prompt обязателен, не более 2000 символов.
Генерация звука: поддерживается generate_audio (boolean).
Референсное аудио: не поддерживается; при передаче вернётся 400.
Необязательные поля: negative_prompt (негативный промпт), seed (целое число).

Референсные изображения и видео

Референсные изображения передаются в images верхнего уровня, референсные видео — в metadata.referenceVideos. Не более 30 изображений (включая первый и последний кадр) и 10 видео.

{
  "model": "kling-3.0-turbo",
  "resolution": "1080p",
  "prompt": "Сохранить внешний вид продукта с изображений и ритм камеры из референсного видео, продукт медленно вращается на столе",
  "duration": 10,
  "ratio": "16:9",
  "generate_audio": true,
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-side.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"]
  }
}

Первый и последний кадр

Первый и последний кадр передаются в metadata.firstFrame и metadata.lastFrame. lastFrame требует firstFrame. Kling позволяет передавать первый и последний кадр вместе с референсными изображениями, всего не более 30 изображений.

{
  "model": "kling-3.0-turbo",
  "resolution": "4k",
  "prompt": "Камера переходит от побережья на рассвете к той же бухте на закате",
  "duration": 5,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

Загрузка файлов

Одно локальное изображение можно также передать напрямую через multipart/form-data в поле input_reference; в этом случае не передавайте в том же запросе images или image. Референсное видео нельзя передать файлом: сначала получите URL, как описано в разделе Загрузка локальных файлов.

Устаревшие названия моделей

Прежние названия с суффиксом уровня kling-3.0-turbo-720p, kling-3.0-turbo-1080p, kling-3.0-turbo-2k, kling-3.0-turbo-4k выведены из обращения 2026-10-10: запрос с ними возвращает ошибку. Используйте kling-3.0-turbo и выбирайте уровень полем resolution.