Как пользоваться Kling 3.0 API: ключ, запрос, опрос задачи, кадры и многоплановые ролики

Чтобы пользоваться Kling 3.0 API, создайте API-ключ, отправьте POST-запросом одно JSON-тело с ID модели kling-3-0 и вашим промптом и опрашивайте возвращённую задачу, пока не будет готов URL видео. Одна конечная точка покрывает текст в видео, видео по первому и последнему кадру, многоплановые ролики и элементы-референсы; что именно получится, решают поля в теле запроса.

В этой инструкции каждый шаг разобран на рабочем коде, а затем показаны кадры, многоплановые ролики, элементы и запросы, которые отклоняются ещё до какого-либо списания.

Что нужно перед первым запросом?

1. API-ключ. Создайте его на странице API-ключей и храните на своём сервере. Никогда не размещайте его в коде для браузера.
2. Кредиты. Пополните баланс на странице оплаты. Кредиты не сгорают, а неудачные задачи не оплачиваются.
3. ID модели kling-3-0.

export SEEDROUTER_API_KEY="your-key"

Как отправить запрос к Kling 3.0?

Отправьте задачу POST-запросом на /v1/videos/generations:

curl https://api.seedrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-3-0",
    "prompt": "A red paper boat drifting on a calm pond at sunrise, soft mist on the water, slow push-in, no text, no logos.",
    "mode": "std",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

В ответе приходит задача, а не видео:

{"id": "task_...", "model": "kling-3-0", "status": "processing", "created_at": 1789689600}

У каждого поля, кроме model и prompt, есть значение по умолчанию:

Схема строгая: неизвестное поле отклоняется с HTTP 400 ещё до создания задачи, поэтому опечатка никогда не превратится в оплаченный ролик, в котором настройка молча проигнорирована.

Как получить видео?

Опрашивайте GET /v1/tasks/{id} каждые 10–20 секунд, пока status не станет completed или failed. В наших тестах ролик std на 3 секунды был готов примерно за две минуты, а ролик pro на 5 секунд со звуком — примерно за две с половиной.

import os
import time
import requests

API = "https://api.seedrouter.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['SEEDROUTER_API_KEY']}"}

task = requests.post(
    f"{API}/videos/generations",
    headers=HEADERS,
    json={
        "model": "kling-3-0",
        "prompt": "A red paper boat drifting on a calm pond at sunrise, slow push-in, no text, no logos.",
        "mode": "std",
        "duration": 5,
    },
    timeout=60,
)
task.raise_for_status()
task_id = task.json()["id"]

while True:
    result = requests.get(f"{API}/tasks/{task_id}", headers=HEADERS, timeout=60).json()
    if result["status"] in ("completed", "failed"):
        break
    time.sleep(15)

if result["status"] == "completed":
    print(result["output"]["video_url"])
else:
    print(result["error"])

Готовая задача выглядит так:

{
  "id": "task_...",
  "model": "kling-3-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

std пришёл в 1280 × 720, а pro — в 1920 × 1080, оба в MP4 (H.264); при включённом sound в файле есть стереодорожка. Скачайте файл в собственное хранилище: ссылки на размещённые файлы не вечны. Сетевой тайм-аут во время опроса не означает, что генерация завершилась сбоем, поэтому сохраните ID задачи и проверьте её снова, а не отправляйте новую задачу.

Как начать с первого и последнего кадра?

Передайте один или два URL изображений в image_urls. Первое изображение открывает ролик, второе — то, чем он заканчивается. Без изображений ролик создаётся только по промпту.

{
  "model": "kling-3-0",
  "prompt": "The camera glides from the empty street to the lit shop window",
  "image_urls": ["https://example.com/start.png", "https://example.com/end.png"],
  "mode": "pro",
  "duration": 6
}

Изображения должны быть публичными URL по HTTP(S), в формате JPG или PNG. Данные в base64 отклоняются; сначала загрузите файл в собственное хранилище.

Как сделать многоплановый ролик?

Задайте multi_shots равным true и опишите каждый план в multi_prompt — до пяти планов по 1–12 секунд каждый. В сумме длительности планов должны давать 3–15 секунд, и эта сумма — длина ролика, за которую вы платите; duration не используется.

{
  "model": "kling-3-0",
  "mode": "pro",
  "sound": true,
  "multi_shots": true,
  "multi_prompt": [
    {"prompt": "Wide shot of a small open kitchen, a chef tosses vegetables in a wok, flames rising, warm light.", "duration": 3},
    {"prompt": "Close-up of the wok, vegetables flipping through the flames, oil sizzling, steam drifting.", "duration": 3}
  ]
}

Вот ролик, который этот запрос создал в нашем тесте, — одно видео на 6 секунд со склейкой от общего плана к крупному:

Kling 3.0, pro (1080p), многоплановый 3 + 3 секунды, со звуком.

Как сохранить человека или товар неизменным?

Добавьте его в kling_elements: name, короткое description и 2–4 URL изображений объекта, до трёх элементов на запрос. Упомяните элемент по имени в промпте.

{
  "model": "kling-3-0",
  "prompt": "@hero slowly turns toward the camera in soft window light",
  "kling_elements": [
    {
      "name": "hero",
      "description": "a young woman with short black hair and a yellow raincoat",
      "element_input_urls": ["https://example.com/hero-front.png", "https://example.com/hero-side.png"]
    }
  ]
}

Какие запросы отклоняются до какого-либо списания?

Эти запросы возвращают HTTP 400 при отправке: задача не создаётся, ничего не списывается.

Задача, которая принята, а затем завершилась сбоем, например из-за политики контента модели, возвращает status: "failed" с кодом в error и не оплачивается. Коды перечислены в каталоге ошибок.

Чем это отличается от собственного API Kling?

API Kling для разработчиков использует свои названия полей, а его устаревшая и текущая версии отличаются друг от друга.^[1][2] Если вы переносите интеграцию, сопоставьте поля:

SeedRouter выдаёт результат как задачу, которую вы опрашиваете; callback_url не предоставляется.

Может ли ИИ-агент для программирования сделать это за вас?

Да. На странице Kling 3.0 есть готовый промпт для Claude Code, Codex или Cursor: агент читает ключ из вашего окружения, показывает запрос и его стоимость, ждёт вашего подтверждения, затем отправляет задачу, опрашивает её и скачивает ролик. На той же странице есть Playground, который отправляет ровно то тело запроса, которое отправил бы ваш код.

Вопросы о Kling 3.0 API

Есть ли официальный API Kling 3.0?

Да. Kling публикует API для разработчиков со своими ключами, оплатой в единицах и форматом запроса.^[1][3] SeedRouter — отдельный способ вызывать Kling 3.0 с одним ключом и одним балансом, общим с другими моделями.

Сколько стоит Kling 3.0 API?

Оплата идёт за секунду видео, по режиму и по тому, включён ли звук. В гайде по ценам Kling 3.0 API разобрана стоимость роликов, а на странице модели показаны актуальные тарифы.

Можно ли отменить задачу?

Нет. После приёма задача выполняется до завершения или сбоя. Неудачные задачи не оплачиваются.

Источники

1. Kling AI. Kling 3.0: Text to Video (справочник API, устаревшая версия). Дата обращения: 6 октября 2026 года, kling.ai.
2. Kling AI. Kling 3.0: Image to Video (справочник API, устаревшая версия). Дата обращения: 6 октября 2026 года, kling.ai.
3. Kling AI. Pricing: Video (API для разработчиков). Дата обращения: 6 октября 2026 года, kling.ai.