Kling
Kling — семейство моделей для генерации видео через CDNvideo AI Hub media API.
Base URL
https://api.cdnvideo.ru/app/aihub-router/v1/media
Для работы используется обычный ключ AI Hub в заголовке Authorization. Модель для маршрутизации передаётся в X-Model:
Authorization: Bearer ${AIHUB_API_KEY}
X-Model: kling-3.0-video
Для kling-3.0-video в теле запроса указывайте model_name: kling-v3.
Асинхронная обработка
kling-3.0-video возвращает task_id, а не готовое видео. После создания задачи опрашивайте GET /kling/videos/text2video/{taskId} до статуса succeed, затем заберите URL из data.task_result.videos.
Возможности
| Сценарий | std |
pro |
4k |
|---|---|---|---|
| Text-to-video: single-shot | ✅ | ✅ | ✅ |
| Text-to-video: multi-shot | ✅ | ✅ | ✅ |
| Image-to-video: первый кадр | ✅ | ✅ | ✅ |
| Image-to-video: multi-shot | ✅ | ✅ | ✅ |
| Image-to-video: первый и последний кадры | ✅ | ✅ | ✅ |
| Subject control | ✅ | ✅ | ✅ |
| Motion control | ✅ | ✅ | ❌ |
| Voice control | ❌ | ❌ | ❌ |
Текущая ручка
На этой странице описан text-to-video интерфейс POST /kling/videos/text2video. Остальные сценарии из карты возможностей могут использовать отдельные Kling video endpoints.
Создание text-to-video задачи
POST /kling/videos/text2video
Метод создаёт задачу генерации видео по текстовому промпту. Поддерживаются single-shot и multi-shot сценарии.
Параметры запроса
| Поле | Тип | Обязательное | По умолчанию | Описание |
|---|---|---|---|---|
model_name |
string |
Нет | kling-v1 |
Имя модели на стороне Kling. Для kling-3.0-video используйте kling-v3. Также встречаются значения MaaS_KeLing_V2.1_master, MaaS_KeLing_V2.5_turbo, MaaS_KeLing_V2.6, MaaS_KeLing_3.0_video. |
multi_shot |
boolean |
Нет | false |
Включает multi-shot генерацию. Если true, поле prompt игнорируется. Если false, поля shot_type и multi_prompt игнорируются. |
shot_type |
string |
Для custom multi-shot | Пусто | Метод раскадровки: customize или intelligence. Если multi_shot: true и shot_type: customize, поле обязательно. |
prompt |
string |
Зависит от режима | Пусто | Текстовый промпт с положительными и отрицательными описаниями. Максимальная длина: 2500 символов. Обязателен, когда multi_shot: false или shot_type: intelligence. |
multi_prompt |
array<object> |
Для custom multi-shot | Пусто | Список промптов для отдельных сцен. Обязателен, когда multi_shot: true и shot_type: customize. |
multi_prompt[].index |
integer |
Да | — | Номер сцены. Поддерживается от 1 до 6 сцен. |
multi_prompt[].prompt |
string |
Да | — | Промпт сцены. Максимальная длина описания одной сцены: 512 символов. |
multi_prompt[].duration |
string или integer |
Да | — | Длительность сцены в секундах. Сумма длительностей всех сцен должна равняться duration задачи. |
negative_prompt |
string |
Нет | Пусто | Негативный промпт до 2500 символов. Рекомендуется включать негативные описания в основной prompt. |
sound |
string |
Нет | off |
Генерировать звук вместе с видео: on или off. Поддерживается моделями версии V2.6 и выше. |
mode |
string |
Нет | std |
Режим генерации: std, pro, 4k. |
aspect_ratio |
string |
Нет | 16:9 |
Соотношение сторон видео: 16:9, 9:16, 1:1. |
duration |
string |
Нет | 5 |
Длительность видео в секундах. Возможные значения: 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. |
watermark_info |
object |
Нет | Пусто | Настройка одновременной генерации результата с водяным знаком. Кастомные водяные знаки сейчас не поддерживаются. |
watermark_info.enabled |
boolean |
Нет | — | true — сгенерировать результат с водяным знаком, false — без водяного знака. |
external_task_id |
string |
Нет | — | Пользовательский ID задачи. Не заменяет системный task_id, но позволяет искать задачу по внешнему ID. Должен быть уникальным в рамках пользователя. |
Режимы качества
| Режим | Описание | Выходное разрешение |
|---|---|---|
std |
Стандартный режим, базовая стоимость и высокая эффективность. | 720P |
pro |
Экспертный режим с лучшим качеством. | 1080P |
4k |
4K-режим с качеством уровня pro. |
4K |
Single-shot text-to-video
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/kling/videos/text2video \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: kling-3.0-video" \
-d '{
"model_name": "kling-v3",
"prompt": "Epic BBC natural history documentary style, 4K ultra-high-definition quality. In the twilight of the African savannah, dust swirls as a brutal struggle for survival unfolds. A massive lion roars in golden sunset light while spotted hyenas encircle it with raw, untamed tension.",
"mode": "pro",
"sound": "on",
"aspect_ratio": "16:9",
"duration": "5"
}'
Ответ
{
"code": 0,
"message": "SUCCEED",
"data": {
"task_id": "868602593017598033",
"task_status": "processing",
"created_at": 1775119514814,
"updated_at": 1775119524744,
"task_status_msg": "",
"task_info": {
"parent_video": null
},
"task_result": {}
},
"request_id": "ea45fa79-c2bf-4545-922f-5647c5d5218d"
}
Multi-shot text-to-video
Для ручной раскадровки используйте multi_shot: true, shot_type: customize и массив multi_prompt. Сумма длительностей сцен должна равняться общей duration.
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/kling/videos/text2video \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: kling-3.0-video" \
-d '{
"model_name": "kling-v3",
"multi_shot": true,
"shot_type": "customize",
"multi_prompt": [
{
"index": 1,
"prompt": "Wide establishing shot of a futuristic city at sunrise, cinematic haze.",
"duration": "3"
},
{
"index": 2,
"prompt": "Close-up of a courier running through neon streets, dynamic camera movement.",
"duration": "4"
}
],
"mode": "pro",
"aspect_ratio": "16:9",
"duration": "7"
}'
Для автоматической раскадровки используйте multi_shot: true, shot_type: intelligence и общий prompt.
Получение статуса задачи
GET /kling/videos/text2video/{taskId}
Метод возвращает статус задачи и URL готового видео, когда генерация завершена.
Path-параметры
| Параметр | Тип | Обязательное | Описание |
|---|---|---|---|
taskId |
string |
Да | ID задачи из поля data.task_id. |
Пример curl
curl https://api.cdnvideo.ru/app/aihub-router/v1/media/kling/videos/text2video/868602593017598033 \
-H "Authorization: Bearer ${AIHUB_API_KEY}" \
-H "Content-Type: application/json" \
-H "X-Model: kling-3.0-video"
Ответ завершённой задачи
{
"code": 0,
"message": "SUCCEED",
"data": {
"task_id": "868890153925369900",
"task_status": "succeed",
"created_at": 1775188074674,
"updated_at": 1775188152228,
"task_status_msg": "",
"task_info": {
"parent_video": null
},
"task_result": {
"videos": [
{
"id": "868890154063794228",
"url": "https://example.com/generated-video.mp4",
"duration": "5.041",
"watermark_url": null
}
]
},
"final_unit_deduction": "6"
},
"request_id": "21ff9a73-562f-4b7e-9f9a-4e12994cc080"
}
Статусы задачи
| Статус | Описание |
|---|---|
submitted |
Задача создана. |
processing |
Задача выполняется. |
succeed |
Задача успешно завершена. |
failed |
Задача завершилась ошибкой. |
Типовой сценарий
- Создайте задачу через
POST /kling/videos/text2video. - Сохраните
data.task_idиз ответа. - Опрашивайте
GET /kling/videos/text2video/{taskId}до статусаsucceed. - Заберите видео из
data.task_result.videos[].url.
Ограничения
- Для
kling-3.0-videoуказывайтеX-Model: kling-3.0-videoиmodel_name: kling-v3. promptиnegative_promptподдерживают до2500символов.- В custom multi-shot поддерживается от
1до6сцен. - Длительность каждой сцены должна быть не меньше
1секунды, а сумма длительностей должна равняться общейduration. durationпринимает значения от3до15секунд.aspect_ratioпринимает значения16:9,9:16,1:1.- Voice control сейчас не поддерживается.