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

Чтобы пользоваться API Kling 4.0, создайте API-ключ, отправьте одно тело JSON методом POST с ID модели kling-4-0 и вашим промптом, затем опрашивайте возвращённую задачу, пока URL видео не будет готов. Одна конечная точка охватывает все пять режимов: текст в видео, видео из изображения до 10 кадров, генерация по референсам из изображений, видео и аудио, редактирование видео и удлинение. Медиа, которое вы отправляете, и одно поле omni_reference_task_type решают, какой режим запускается.

Это руководство проходит через каждый режим с телами запросов, которые работали 22 октября 2026, затем показывает, как каждый режим оплачивается и какие запросы отклоняются до любого списания.

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

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

export SEEDROUTER_API_KEY="your-key"

Как отправить запрос к Kling 4.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-4-0",
    "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, signs shimmering in the puddles, the camera tracking low beside her. No text, no logos.",
    "resolution": "720p",
    "duration": 5,
    "aspect_ratio": "16:9"
  }'

Ответ — это задача, не видео:

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

Каждое поле, кроме model и большинства режимов prompt, имеет значение по умолчанию:

Нет переключателя звука: каждый ролик Kling 4.0 имеет стереодорожку. Также нет полей mode, negative_prompt или watermark. Схема строгая, поэтому неизвестное поле отклоняется с HTTP 400 перед созданием задачи, и опечатка никогда не превращается в оплаченный ролик с молча игнорируемой настройкой.

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

Опрашивайте GET /v1/tasks/{id} каждые 10–20 секунд, пока status не станет completed или failed. Наши пять тестовых прогонов заняли между 2 минут 41 секунд и 4 минут 22 секунд для 3-секундных роликов 720p, поэтому планируйте на минуты, а не на секунды.

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-4-0",
        "prompt": "A woman with a red umbrella walks down a neon-lit street on a rainy night, no text, no logos.",
        "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-4-0",
  "status": "completed",
  "output": {"video_url": "https://static.seedrouter.ai/media/tasks/task_example/0.mp4"}
}

Это клип, который создал первый запрос на этой странице, 5 секунд при 720p:

Kling 4.0, text to video, 720p, 5 seconds, with stereo sound.

Наши ролики 720p возвращались как MP4 (H.264) с разрешением 1280 × 720 и стереодорожкой AAC. Скачайте файл в свое хранилище: размещённые ссылки не постоянны. Перерыв в сети при опросе не означает, что генерация не удалась, поэтому сохраняйте ID задачи и проверяйте её снова вместо отправки новой задачи.

Какой режим запускает запрос Kling 4.0?

Медиа в теле выбирают режим. omni_reference_task_type делает его явным, когда медиа одного не хватает, чтобы избежать двусмысленности:

Кадры и медиа-референсы не могут быть смешаны в одном запросе, и video_url без edit или extend отклоняется. Оба приходят назад как HTTP 400 перед созданием задачи.

Как закрепить ключевые кадры в Kling 4.0?

Отправьте image_with_roles, список объектов {url, role}. Ровно один first_frame, опциональный last_frame и до 8 записей keyframe, всего 10 изображений. Ключевые кадры используются в порядке, который вы их перечисляете, поэтому список — это временная шкала.

{
  "model": "kling-4-0",
  "prompt": "A girl walks from the window to the door, then looks back and smiles",
  "image_with_roles": [
    {"url": "https://example.com/1.png", "role": "first_frame"},
    {"url": "https://example.com/2.png", "role": "keyframe"},
    {"url": "https://example.com/3.png", "role": "last_frame"}
  ],
  "duration": 10
}

Для просто начала и конца image_urls: [first, last] короче. Видео из изображения — единственный режим, где prompt может быть пропущен; клип берёт форму первого кадра.

Как пользоваться референсами на изображения, видео и аудио?

Добавьте video_urls (до 5 клипов, в сумме 30 секунд), audio_urls (до 3 клипов по 5–30 секунд) и изображения-референсы, всего не более 15 файлов. Упоминайте их в промпте как @Image1, @Video1 и @Audio1, нумеруя с 1 в каждом списке:

{
  "model": "kling-4-0",
  "prompt": "The woman from @Image1 walks along the deck of the sailboat from @Video1 at sunset",
  "image_with_roles": [{"url": "https://example.com/woman.png", "role": "reference_image"}],
  "video_urls": ["https://example.com/boat.mp4"],
  "aspect_ratio": "auto",
  "duration": 5
}

Изображения-референсы могут также идти в image_urls, но только с omni_reference_task_type: "reference"; без него image_urls читаются как первый и последний кадры. Собственный звук видео-референсов заменяется по умолчанию; установите audio_setting: "origin", чтобы сохранить его.

Как редактировать видео с помощью Kling 4.0?

Установите omni_reference_task_type на edit, передайте видео в video_url и опишите изменение. До 10 изображений-референсов могут идти в image_urls.

{
  "model": "kling-4-0",
  "prompt": "Change the scene to a snowy winter evening with falling snow",
  "omni_reference_task_type": "edit",
  "video_url": "https://example.com/in.mp4"
}

Входное видео должно быть не менее 3 секунд длиной, и используются только его первые 30 секунд. Оставьте duration и результат следует длине входного видео; оригинальный звук сохраняется, если вы не установите audio_setting: "auto".

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

Установите omni_reference_task_type на extend, передайте видео и дайте duration как длину новой части. Kling 4.0 продолжается с последнего кадра и возвращает оригинал плюс новые секунды как один файл. В нашем тесте клип на 5,2 секунды, удлинённый на 3 секунды, вернулся длиной 8,1 секунды.

{
  "model": "kling-4-0",
  "prompt": "The sailboat keeps gliding forward as the sun sets below the horizon",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 3
}

Добавьте last_frame_image, чтобы выбрать, где заканчивается новая часть. Удлинение сохраняет соотношение и звук входного видео, поэтому aspect_ratio и audio_setting отклоняются.

Сколько стоит запрос Kling 4.0?

Kling 4.0 оплачивается за секунду видео по ставке, установленной разрешением. Какие секунды считаются, зависит от режима:

Входное видео — это суммарная длина входных видео, округлённая до целых секунд и ограничена 30. Она измеряется при принятии запроса, поэтому зарезервированная сумма — это зарядная сумма. В нашем тесте редактирования входное видео на 5,2 секунды и результат на 3 секунды выставили счёт 3 + 6 = 9 секунд. Это актуальные ставки:

Видео, чья длина не может быть прочитана, отклоняется до любого списания, и задача, которая не выполнена, не оплачивается.

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

Они приходят назад как HTTP 400 при отправке, без созданной задачи и ничего не оплачивается:

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

Может ли агент кодирования запустить его для вас?

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

Вопросы API Kling 4.0

Является ли API Kling 4.0 свободным?

Нет. Он оплачивается за секунду видео. Новые аккаунты SeedRouter получают небольшой кредит для пробы, нет подписки, и неудачные задачи не оплачиваются.

Находится ли Kling 4.0 Flash в API?

Ещё нет. Kling 4.0 Flash — это отдельная, более лёгкая модель в том же семействе; Kling приводит её с более короткими клипами 720p и без множественных ключевых кадров.^[1] ID модели kling-4-0 — это полная Kling 4.0.

Чем Kling 4.0 отличается от Kling 3.0 в API?

Kling 4.0 создаёт клипы до 30 секунд, берёт ключевые кадры, видео и аудио референсы и может редактировать или удлинять видео; звук всегда включен. Kling 3.0 создаёт 3–15-секундные клипы, предлагает 4K, многоплановые промпты и имеет переключатель звука. Руководство API Kling 3.0 охватывает его поля. Kling объявила 4.0 с её 30-секундной длиной, 10 ключевыми кадрами и стереозвуком 30 сентября 2026.^[2]

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

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

Ссылки

1. Kling AI. Kling 4.0 video generation (обзор возможностей и часто задаваемые вопросы). Проверено 8 октября 2026 на kling.ai.
2. Kling AI. Introducing Kling 4.0: Visual Realism, Creative Control, and Next-Level Storytelling. 30 сентября 2026. Проверено 8 октября 2026 на kling.ai.