Kling 4.0

Kling 4.0 — видеомодель Kuaishou, объявленная в сентябре 2026. Один ID модели охватывает пять режимов: текст в видео, видео по первому кадру до 10 ключевых кадров, генерация по референсам (изображения, видео и аудио), редактирование видео и продление видео. Каждый ролик длится 3–30 секунд при разрешении 720p или 1080p со стереозвуком. Отправьте запрос, сохраните возвращённый ID задачи и получите готовое видео из задачи. Медиа передаются как URL.

ID моделей

Актуальные цены — на странице модели.

Краткий пример

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"
  }'

Конечная точка

POST https://api.seedrouter.ai/v1/videos/generations

Ответ — это задача ({"id": "task_...", "status": "processing"}), а не готовое видео. Опрашивайте GET /v1/tasks/{task_id} до получения результата. Храните API-ключи в коде на стороне сервера.

Параметры

Каждый ролик имеет стереозвук; переключателя звука нет. Нет полей mode, negative_prompt, watermark или многоплановости. Схема строгая: неизвестные поля отклоняются, а не игнорируются. callback_url недоступен; опрашивайте задачу вместо этого.

Режимы

Режим следует из медиа, которое вы отправляете, и omni_reference_task_type:

Кадры и медиа-референсы не могут быть смешаны в одном запросе. Рядом с видео-референсами или аудио image_urls считаются изображениями-референсами только с omni_reference_task_type: "reference"; иначе используйте роли reference_image. video_url без edit или extend отклоняется.

Ключевые кадры

{
  "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
}

Референсы

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

Редактирование

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

Входное видео должно быть не менее 3 секунд; используются только его первые 30 секунд. Без duration выход соответствует входному видео.

Удлинение

{
  "model": "kling-4-0",
  "prompt": "The camera keeps moving forward as the sky grows darker",
  "omni_reference_task_type": "extend",
  "video_url": "https://example.com/in.mp4",
  "duration": 5
}

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

Входные медиа

Изображения, видео и аудио — это публичные URL HTTP(S). Base64 data URI не принимаются: загружайте файлы в свое хранилище и передавайте их URL. Изображения, видео и аудио вместе — не более 15 файлов референсов.

Измерения цены

Проверьте раздел цены модели для актуальных ставок. Kling 4.0 оплачивается за секунду видео по ставке, установленной разрешением:

text, image, reference without videos:  cost = duration × standard rate
extend:                                 cost = new seconds × standard rate
edit, reference with videos:            cost = (output + max(output, input)) × video-input rate

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

Схема выхода

Отправка возвращает задачу:

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

Получить задачу

GET https://api.seedrouter.ai/v1/tasks/{task_id}

Опрашивайте каждые 10–20 секунд, пока status не станет completed или failed. Перерыв в сети при опросе не означает, что генерация не удалась: сохраняйте ID задачи и продолжайте её проверять. Не создавайте новую задачу для проверки прогресса.

Завершённая задача

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

В наших тестах 3-секундные ролики 720p возвращались как MP4 (H.264) с разрешением 1280 × 720 и стереодорожкой AAC через 2 мин 41 с до 4 мин 22 с после отправки. Удлинённое видео на 5,2 секунды вернулось длиной 8,1 секунды.

Ошибки

Запросы, отклоненные до создания задачи, возвращают ошибку HTTP с объектом error и не оплачиваются. Задача, которая не выполнена после принятия, возвращает HTTP 200 при запросе со статусом status: "failed" и объектом error.

Смотрите общий каталог ошибок для кодов, HTTP-статусов и указаний по повторным попыткам.

{
  "id": "task_...",
  "model": "kling-4-0",
  "status": "failed",
  "error": {
    "code": 60001,
    "message": "The request was rejected by the content policy. Please revise the prompt or input images."
  }
}

Если сама отправка истечёт по времени, проверьте ваши задачи перед повторной отправкой: первый запрос мог быть принят.

Советы

• Описывайте субъект, место, движение камеры, свет и звук; аудио ролика следует промпту.
• Создавайте черновик при 720p, затем рендируйте финальный кадр при 1080p с тем же запросом.
• Давайте ключевые кадры для более длинных роликов, чтобы сцена двигалась так, как вам нужно.
• Добавляйте no text, no logos, чтобы избежать придуманных меток.

Связано

• Playground и цены Kling 4.0
• Справка API Kling 3.0
• Скачать OpenAPI
• Копируемый Markdown