# Kling 4.0 API > Видео Kling 4.0 до 30 секунд со звуком в двух режимах. «Кадры»: по описанию и ключевым кадрам, до 10 штук. Omni: из ваших картинок, видео, элементов и готовых голосов, на каждый материал можно сослаться в описании. Разработчик: Kuaishou Ключ модели в API: `kling_pro` ## Подключение в три шага 1. [Получите ключ](https://api.cyhub.ai/docs/connection.md?lang=ru): Ключ создаётся в кабинете после подтверждения почты. Один ключ открывает все модели. 2. [Узнайте цену](https://api.cyhub.ai/docs/generations.md?lang=ru): POST /v1/price считает стоимость запуска заранее, деньги при этом не списываются. 3. [Запустите задачу и заберите результат](https://api.cyhub.ai/docs/tasks.md?lang=ru): POST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы. ## Готовый код Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded. ```bash 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"]) ``` ```javascript 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(); ``` [Получить ключ](https://cyhub.ai/cabinet/keys) ## Цена до запуска Цены на 17.10.2026: от 30 ₽. Точную цену своих настроек покажет POST /v1/price. Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются. ```bash 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: сколько сейчас доступно на балансе для новых задач ## 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, цена зависит от него. - Тип: Строка - Допустимые значения: `720p`, `1080p` - По умолчанию: `"720p"` **Что значат варианты** > **720p:** > Разрешение 1280×720 пикселей > Подходит для соцсетей и быстрого предпросмотра > > **1080p:** > Разрешение 1920×1080 пикселей (Full HD) > Профессиональное качество для рекламы и контента > > **4K:** > Самое чёткое видео, для больших экранов > Только у версии 3.0 #### `length` (Необязательно) Длительность видео в секундах, от 3 до 30. Цена растёт с каждой секундой. - Тип: Целое число - Минимум: 3 - Максимум: 30 - По умолчанию: `5` #### `aspect_ratio` (Необязательно) Пропорции видео без кадров. С любым кадром видео берёт пропорции у кадров. - Тип: Строка - Допустимые значения: `16:9`, `1:1`, `9:16`, `21: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 МБ | [Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru) ### Пример запроса Отправьте этот 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`. [Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru) ### Результат - Одно видео 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" } ] } } ``` [Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result) ## 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_. Например: «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, цена зависит от него. - Тип: Строка - Допустимые значения: `720p`, `1080p` - По умолчанию: `"720p"` **Что значат варианты** > **720p:** > Разрешение 1280×720 пикселей > Подходит для соцсетей и быстрого предпросмотра > > **1080p:** > Разрешение 1920×1080 пикселей (Full HD) > Профессиональное качество для рекламы и контента > > **4K:** > Самое чёткое видео, для больших экранов > Только у версии 3.0 #### `length` (Необязательно) Длительность видео в секундах, от 3 до 30. Цена растёт с каждой секундой. - Тип: Целое число - Минимум: 3 - Максимум: 30 - По умолчанию: `5` #### `aspect_ratio` (Необязательно) Пропорции видео. «auto»: модель подберёт их по материалам. - Тип: Строка - Допустимые значения: `auto` (Авто), `16:9`, `1:1`, `9:16`, `21: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_. - Цена без видео: за секунду ролика. С видео: за секунду ролика и ещё за большее из двух, длины ролика или суммы длин видео, по меньшей ставке. Картинки и элементы цену не меняют. Видео меряем сами, поэтому цену с видео называет POST /v1/price. | Поле | Что принимает | Форматы | Файлов | Размер файла до | |---|---|---|---|---| | `image_urls` | Картинки | jpeg, jpg, png | 10 | 10 МБ | | `video_urls` | Видео | mp4, mov | 5 | 100 МБ | [Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru) ### Пример запроса Отправьте этот 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`. [Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru) ### Результат - Одно видео 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" } ] } } ``` [Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result) ## Смотрите также - [Нейросеть Kling 4.0: возможности и цены](https://api.cyhub.ai/models/kling-4) - Другие версии: [Kling 3.0 API](https://api.cyhub.ai/models/kling-3/api.md), [Kling 2.6 API](https://api.cyhub.ai/models/kling-2-6/api.md), [Kling 2.5 Turbo API](https://api.cyhub.ai/models/kling-2-5-turbo/api.md), [Kling 2.1 Master API](https://api.cyhub.ai/models/kling-2-1-master/api.md), [Kling 2.1 API](https://api.cyhub.ai/models/kling-2-1/api.md), [Kling 1.6 API](https://api.cyhub.ai/models/kling-1-6/api.md) - Похожие модели: [Seedance 2.5 API](https://api.cyhub.ai/models/seedance-2-5/api.md), [Kling Motion 3.0 API](https://api.cyhub.ai/models/kling-motion/api.md), [Veo 3.1 API](https://api.cyhub.ai/models/veo-3-1/api.md), [Wan 3.0 API](https://api.cyhub.ai/models/wan-3/api.md), [MiniMax H3 (Hailuo 03) API](https://api.cyhub.ai/models/minimax-h3/api.md), [Gemini Omni API](https://api.cyhub.ai/models/gemini-omni/api.md) - [Документация API](https://api.cyhub.ai/docs.md?lang=ru) - [Ошибки API и что с ними делать](https://api.cyhub.ai/docs/errors.md?lang=ru)