Обзор API

Как это работает

API kling-4.ai — небольшой набор REST-методов с простым принципом: вы создаёте задачу генерации, затем опрашиваете её до готовности видео.

POST /api/ai-video/jobs          create a generation job
GET  /api/ai-video/jobs/{id}     fetch one job (refreshes provider status)
GET  /api/ai-video/jobs          list your recent jobs
POST /api/ai-video/jobs/sync     refresh all of your active jobs at once

• Базовый URL: https://kling-4.ai
• Аутентификация: одобренный API-ключ в заголовке x-api-key, см. аутентификацию.
• Формат: JSON на входе и выходе.
• Модель: поле model выбирает модель Kling, см. модели. Когда новое поколение Kling станет доступно, в интеграции меняется это поле.

Быстрый старт

1. Получите ключ. Доступ по API-ключам открывается постепенно в рамках v1. Свяжитесь с нами, если нужен серверный доступ.

2. Создайте задачу:

curl -X POST 'https://kling-4.ai/api/ai-video/jobs' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "kling-v2-6",
    "prompt": "A cinematic sunrise over a glass city, slow drone push-in",
    "parameters": {
      "mode": "std",
      "duration": 5,
      "aspectRatio": "16:9"
    }
  }'

Ответ содержит задачу, которую нужно опрашивать:

{
  "job": {
    "id": "0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41",
    "model": "kling-v2-6",
    "status": "queued",
    "progress": 0,
    "resultUrl": null,
    "createdAt": "2026-07-09T03:12:45.000Z"
  }
}

3. Опрашивайте до завершения:

curl 'https://kling-4.ai/api/ai-video/jobs/0b6c2f6e-6d5f-4a4e-9d3e-7c9a1f2b8d41' \
  -H 'x-api-key: YOUR_API_KEY'

Когда status станет completed, задача будет содержать resultUrl с видеофайлом и thumbnailUrl. Генерация обычно занимает несколько минут; достаточно опроса каждые 10–15 секунд. Ссылки resultUrl имеют срок действия: проверьте resultExpiresAt и скачайте файл вовремя.

Рабочие примеры на Node.js и Python вместе с библиотекой проверенных промптов находятся в нашем репозитории awesome-kling-4 на GitHub.

Методы API

Квоты

Гости браузера могут вручную получать бесплатные кредиты один раз за соответствующую условиям дату UTC. Для каждой поддерживаемой конфигурации показана стоимость. Запрос принимается, только если баланса хватает на окончательную стоимость, рассчитанную сервером. Одобренные API-ключи используют кредиты или квоту своего рабочего пространства. Об ответах при нехватке кредитов и ошибках проверки запроса читайте в разделе ошибок. Для большего объёма свяжитесь с нами.