Обзор 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 4.0 на сайте не означает доступ через API. Прежний маршрут не принимает kling-v4; используйте документированные идентификаторы.

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

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-ключи используют кредиты или квоту своего рабочего пространства. Об ответах при нехватке кредитов и ошибках проверки запроса читайте в разделе ошибок. Для большего объёма свяжитесь с нами.