Kling 4.0 API

Видео Kling 4.0 до 30 секунд со звуком в двух режимах. «Кадры»: по описанию и ключевым кадрам, до 10 штук. Omni: из ваших картинок, видео, элементов и готовых голосов, на каждый материал можно сослаться в описании.

Разработчик: KuaishouКлюч модели в API: kling_pro

Для нейросети:Скачать .md Вся документация .md Открыть как текст

Подключение в три шага

Получите ключКлюч создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
Узнайте ценуPOST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
Запустите задачу и заберите результатPOST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.

Готовый код

Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.

cURLPythonNode.js

cURL

curl -X POST "https://api.cyhub.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling_pro",
  "settings": {
    "model_version": "v4.0",
    "prompt": "Котёнок с Frame_first прыгает на диван и сворачивается клубком, как на Frame_1",
    "start_frame": [
      "https://example.com/kitten.jpg"
    ],
    "middle_frames": [
      "https://example.com/kitten-sofa.jpg"
    ],
    "length": 5,
    "quality": "1080p"
  }
}'

curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python

import time

import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

body = {
    "model": "kling_pro",
    "settings": {
        "model_version": "v4.0",
        "prompt": "Котёнок с Frame_first прыгает на диван и сворачивается клубком, как на Frame_1",
        "start_frame": [
            "https://example.com/kitten.jpg",
        ],
        "middle_frames": [
            "https://example.com/kitten-sofa.jpg",
        ],
        "length": 5,
        "quality": "1080p",
    },
}

response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
    time.sleep(5)
    task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])

Node.js

const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };

const body = {
  "model": "kling_pro",
  "settings": {
    "model_version": "v4.0",
    "prompt": "Котёнок с Frame_first прыгает на диван и сворачивается клубком, как на Frame_1",
    "start_frame": [
      "https://example.com/kitten.jpg"
    ],
    "middle_frames": [
      "https://example.com/kitten-sofa.jpg"
    ],
    "length": 5,
    "quality": "1080p"
  }
};

async function main() {
  let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
  if (!response.ok) throw new Error(await response.text());
  let task = await response.json();
  while (task.status === "queued" || task.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 5000));
    response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
    task = await response.json();
  }
  console.log(task.status, task.result);
}

main();

Получить ключ

Цена до запуска

Цены на 17.10.2026: от 30 ₽. Точную цену своих настроек покажет POST /v1/price.

Режим	Цена
Kling 4.0, кадры	от 30 ₽
Kling 4.0 Omni	от 30 ₽

Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.

cURL

curl -X POST "https://api.cyhub.ai/v1/price" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "model": "kling_pro",
  "settings": {
    "model_version": "v4.0",
    "prompt": "Котёнок с Frame_first прыгает на диван и сворачивается клубком, как на Frame_1",
    "start_frame": [
      "https://example.com/kitten.jpg"
    ],
    "middle_frames": [
      "https://example.com/kitten-sofa.jpg"
    ],
    "length": 5,
    "quality": "1080p"
  }
}'

amount_minor: цена запуска в копейках (для рублей)
currency: валюта кошелька
available_minor: сколько сейчас доступно на балансе для новых задач

Режимы

У каждого режима свои параметры и примеры. Режим выбирает поле model_version.

Kling 4.0, кадры model_version = v4.0
Kling 4.0 Omni model_version = v4.0-omni

Что значат варианты

1.6 — Sound Effects, начальный/финальный кадр

2.1 — 3D-движение, детализация лиц, Sound Effects

2.1 Master — Кинематографическое качество, только 1080p, Sound Effects

2.5 Turbo — На 40% быстрее, реалистичная физика, Sound Effects

2.6 — Встроенная генерация аудио, 1080p/48 FPS

3.0 — Multi-Shot, привязка элементов, до 15 секунд

4.0: два режима. «Кадры»: до 10 ключевых кадров. Omni: картинки, видео и элементы. До 30 секунд, со звуком

Kling 4.0, кадры

Видео по описанию и ключевым кадрам: начальный, промежуточные и финальный, всего до 10. От 3 до 30 секунд, 720p или 1080p, всегда со звуком. Элементов в этом режиме нет.

Значение поля model_version: v4.0

Цена в этом режиме от 30 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что происходит в видео: действие, движение камеры, настроение сцены. На кадр можно сослаться меткой: Frame_first (начальный), Frame_last (финальный), Frame_1, Frame_2 и дальше (промежуточные по порядку).
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
start_frameНеобязательно: Одна ссылка на картинку, с которой начнётся видео.
Тип: Список (Строка, uri)Максимум элементов: 1
middle_framesНеобязательно: Промежуточные кадры по порядку, до 8 ссылок на картинки: через них видео пройдёт по ходу. Всего кадров с начальным и финальным до 10 и не больше, чем секунд в видео, плюс один (на 3 секунды до 4 кадров). Начальный и финальный необязательны.
Тип: Список (Строка, uri)Максимум элементов: 8
end_frameНеобязательно: Одна ссылка на картинку, которой закончится видео. Можно и без начального кадра.
Тип: Список (Строка, uri)Максимум элементов: 1
qualityНеобязательно: Качество: 720p или 1080p, цена зависит от него.
Тип: СтрокаДопустимые значения: 720p1080pПо умолчанию: "720p"
Что значат варианты
720p:
Разрешение 1280×720 пикселей
Подходит для соцсетей и быстрого предпросмотра

1080p:
Разрешение 1920×1080 пикселей (Full HD)
Профессиональное качество для рекламы и контента

4K:
Самое чёткое видео, для больших экранов
Только у версии 3.0
lengthНеобязательно: Длительность видео в секундах, от 3 до 30. Цена растёт с каждой секундой.
Тип: Целое числоМинимум: 3Максимум: 30По умолчанию: 5
aspect_ratioНеобязательно: Пропорции видео без кадров. С любым кадром видео берёт пропорции у кадров.
Тип: СтрокаДопустимые значения: 16:91:19:1621:9По умолчанию: "16:9"
Действует, только когда: start_frame не задано и end_frame не задано и middle_frames не задано

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: api_request = true

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

Кадры передаются ссылками на JPG или PNG до 10 МБ: сторона не меньше 300 пикселей, пропорции от 1:2,5 до 2,5:1.
Кадры мы скачиваем сами: ссылка должна открываться без входа и вести прямо на файл, без переадресации.
Кадров всего до 10 и не больше, чем секунд в видео, плюс один: на 3 секунды до 4 кадров, на 9 секунд и дольше до 10. Любой кадр можно пропустить, промежуточный бывает и без начального. Своего времени у промежуточного кадра нет: кадры идут по порядку.
Элементов в этом режиме нет: Kling берёт их только в 3.0 и в 4.0 Omni.
Цена: за секунду видео, от числа кадров не зависит.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`start_frame`	Картинки	jpeg, jpg, png	1	10 МБ
`middle_frames`	Картинки	jpeg, jpg, png	8	10 МБ
`end_frame`	Картинки	jpeg, jpg, png	1	10 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Начальный кадр и промежуточный, без финального

JSON

{
  "model": "kling_pro",
  "settings": {
    "model_version": "v4.0",
    "prompt": "Котёнок с Frame_first прыгает на диван и сворачивается клубком, как на Frame_1",
    "start_frame": [
      "https://example.com/kitten.jpg"
    ],
    "middle_frames": [
      "https://example.com/kitten-sofa.jpg"
    ],
    "length": 5,
    "quality": "1080p"
  }
}

Видео по описанию

JSON

{
  "model": "kling_pro",
  "settings": {
    "model_version": "v4.0",
    "prompt": "Маяк на скале во время шторма, камера медленно облетает его",
    "length": 10,
    "aspect_ratio": "21:9"
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4, со звуком, если он включён.
Генерация обычно занимает 3-5 минут.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Kling 4.0 Omni

Видео из ваших материалов: картинки, видео и элементы, ссылки на них в описании. От 3 до 30 секунд, 720p или 1080p, всегда со звуком.

Значение поля model_version: v4.0-omni

Цена в этом режиме от 30 ₽.

Параметры

Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.

promptОбязательно: Что сделать с материалами и что происходит в видео. На материал ссылаются меткой: Image_1 (первая картинка из image_urls), Video_1 (первое видео из video_urls) и дальше по порядку, элемент из библиотеки меткой Element_<id>. Например: «Image_1 идёт к камере на фоне из Video_1».
Тип: СтрокаМинимум символов: 1Максимум символов: 5000
image_urlsНеобязательно: Картинки, до 10: герои, предметы, места, стиль. На цену не влияют.
Тип: Список (Строка, uri)Максимум элементов: 10
video_urlsНеобязательно: Видео, до 5: фон, движение, герой или звук. Все вместе от 2 до 30 секунд, короткая сторона кадра от 700 пикселей. Уходят целиком, без обрезки. Цена зависит и от длины видео.
Тип: Список (Строка, uri)Максимум элементов: 5
keep_original_soundНеобязательно: Оставить в ролике звук вашего видео: новый звук модель тогда не делает. Только с видео.
Тип: Да/нетПо умолчанию: false
Действует, только когда: video_urls задано
qualityНеобязательно: Качество: 720p или 1080p, цена зависит от него.
Тип: СтрокаДопустимые значения: 720p1080pПо умолчанию: "720p"
Что значат варианты
720p:
Разрешение 1280×720 пикселей
Подходит для соцсетей и быстрого предпросмотра

1080p:
Разрешение 1920×1080 пикселей (Full HD)
Профессиональное качество для рекламы и контента

4K:
Самое чёткое видео, для больших экранов
Только у версии 3.0
lengthНеобязательно: Длительность видео в секундах, от 3 до 30. Цена растёт с каждой секундой.
Тип: Целое числоМинимум: 3Максимум: 30По умолчанию: 5
aspect_ratioНеобязательно: Пропорции видео. «auto»: модель подберёт их по материалам.
Тип: СтрокаДопустимые значения: auto16:91:19:1621:9По умолчанию: "auto"

Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.

Эти настройки API задаёт сам, передавать их не нужно: api_request = true

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

Кадры передаются ссылками на JPG или PNG до 10 МБ: сторона не меньше 300 пикселей, пропорции от 1:2,5 до 2,5:1.
Кадры мы скачиваем сами: ссылка должна открываться без входа и вести прямо на файл, без переадресации.
Материалов всего до 15: картинок до 10, видео до 5, элементов до 7 (видео-элементов до 3, видео и видео-элементов вместе до 5).
Элементы из библиотеки кабинета (GET /v1/models/kling_pro/elements) вставляются в описание меткой Element_<id>.
Цена без видео: за секунду ролика. С видео: за секунду ролика и ещё за большее из двух, длины ролика или суммы длин видео, по меньшей ставке. Картинки и элементы цену не меняют. Видео меряем сами, поэтому цену с видео называет POST /v1/price.

Поле	Что принимает	Форматы	Файлов	Размер файла до
`image_urls`	Картинки	jpeg, jpg, png	10	10 МБ
`video_urls`	Видео	mp4, mov	5	100 МБ

Как передать файлы

Пример запроса

Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.

Фон из видео, герой с картинки

JSON

{
  "model": "kling_pro",
  "settings": {
    "model_version": "v4.0-omni",
    "prompt": "Возьми фон из Video_1, а героя с Image_1: он идёт к камере",
    "image_urls": [
      "https://example.com/hero.png"
    ],
    "video_urls": [
      "https://example.com/street.mp4"
    ],
    "length": 8,
    "aspect_ratio": "auto"
  }
}

Цена считается при приёме задачи, валюта RUB.

Полный пример запуска

Результат

Одно видео MP4, со звуком, если он включён.
Генерация обычно занимает 3-5 минут.

Вид (kind)	Форматы	Сколько	Пояснение
`video`	mp4	1

JSON

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "succeeded",
  "finished_at": "2026-10-01T12:03:41+00:00",
  "result": {
    "caption": "Подпись к результату: модель и настройки",
    "texts": [],
    "files_expire_at": "2026-10-08T12:03:41+00:00",
    "files_expired": false,
    "artifacts": [
      {
        "index": 0,
        "kind": "video",
        "filename": "video.mp4",
        "size": 12582912,
        "caption": "",
        "download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
      }
    ]
  }
}

Как читать результат и скачивать файлы

Смотрите также

Нейросеть Kling 4.0: возможности и цены
Другие версии: Kling 3.0 API, Kling 2.6 API, Kling 2.5 Turbo API, Kling 2.1 Master API, Kling 2.1 API, Kling 1.6 API
Похожие модели: Seedance 2.5 API, Kling Motion 3.0 API, Veo 3.1 API, Wan 3.0 API, MiniMax H3 (Hailuo 03) API, Gemini Omni API
Документация API
Ошибки API и что с ними делать

Попробуйте Kling 4.0 через API

Один ключ открывает все модели CyHUB. Оплата в рублях, цену видно до запуска.

Получить ключ API