Перейти к содержанию

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 Задача завершилась ошибкой.

Типовой сценарий

  1. Создайте задачу через POST /kling/videos/text2video.
  2. Сохраните data.task_id из ответа.
  3. Опрашивайте GET /kling/videos/text2video/{taskId} до статуса succeed.
  4. Заберите видео из 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 сейчас не поддерживается.