Генерация видео Omni

Генерируйте или редактируйте Kling 4.0 с разными видами референсов.

feature_video заимствует признаки и ритм движения, base_video редактирует готовое видео. Изображения, видео, элементы и голоса: до 15 вместе, с соблюдением отдельных ограничений. Элементы/голоса используют существующие ID; API управления ресурсами здесь не описаны.

POST/kling/omni-video/kling-4.0

Промпты, изображения, видео, элементы и голоса для генерации/редактирования. feature_video — референс, base_video — редактирование. Модель Kling 4.0 та же, что в двух других API.

Аутентификация

bearerAuth

АутентификацияBearer <token>

API Key платформы: Authorization: Bearer your-api-key.

Расположение: header

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

contents*array<||||>

Промпт и необязательные референсы; изображения, видео, элементы, голоса суммарно до 15, с отдельными лимитами.

Элементы1 <= items

settings?

options?

Тело ответа

`application/json`

curl -X POST "https://api.agtcloud.cn/kling/omni-video/kling-4.0" \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "type": "prompt",
        "text": "Использовать стиль @scene для воздушной съёмки побережья."
      },
      {
        "type": "refer_image",
        "id": "scene",
        "url": "https://example.com/scene.jpg"
      }
    ],
    "settings": {
      "duration": 5,
      "resolution": "1080p",
      "aspect_ratio": "adaptive"
    }
  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "id": "123456789012345678",
    "status": "submitted",
    "message": "",
    "create_time": 1792713600000,
    "update_time": 1792713600000
  }
}

Типы ресурсов и ссылки

contents должен содержать промпт type: "prompt". Другие ресурсы добавляйте по необходимости. id применяется для @reference в промпте; ID ссылок уникальны в задаче.

Ресурс	`type`	Источник и обязательные поля
Изображение	`first_frame` / `middle_frame` / `last_frame` / `refer_image`	`url` обязателен, URL/Base64; `id` необязателен
Видео	`feature_video` / `base_video`	`url` обязателен, URL видео; `id` необязателен
Элемент	`element`	Обязательны `element_id` и `id`
Голос	`voice`	Обязательны `voice_id` и `id`

element_id — системный ID элемента из API элементов. voice_id — ID голоса из API настройки или официальных пресетов. Это не ID ссылки id внутри запроса.

См. официальное руководство библиотеки элементов и документацию голосов. Используйте ID нужного региона, не переносите пресеты из других регионов.

Ограничения ресурсов

Ресурс	Формат и размер	Размеры, длительность, количество
Изображение	JPG, JPEG, PNG; до 30MB каждое	Ширина/высота от 300px; пропорции 2:5～5:2; до 10
Видео	MP4, MOV; до 300MB каждое	Каждое и весь ввод: 3～30 секунд; размеры 700～4553px, до 8294400 пикселей; пропорции 2:5～5:2; ввод 24～60fps, вывод 24fps
Элемент	Многоизображенческий или видеоперсонаж	До 7, включая до 3 видеоперсонажей
Голос	Существующий пользовательский или системный	До 3

Сочетания также должны удовлетворять условиям:

Сумма изображений, видео, элементов и голосов не больше 15.
Видео и видеоперсонажей вместе не больше 5; base_video максимум 1.
Общая длительность включает feature_video, base_video и исходные видео видеоперсонажей.

Частые ошибки и решения

Ответ или ошибка	Проверка и действие
HTTP 401, `Invalid token`	Проверьте Bearer и принадлежность API Key сайту
HTTP 400, `contents cannot be empty`	Передайте непустой массив `contents`
HTTP 400, `prompt cannot be empty`	Добавьте в `contents` непустой текст типа `type: "prompt"`
HTTP 400, `contents[0].type ... is invalid`	Проверьте допустимый тип и указанный индекс
HTTP 400, `Invalid element id`	Проверьте `element_id`, не подставляйте ссылку `id` вместо ID элемента
HTTP 400, `Invalid voice id`	Проверьте `voice_id`, не подставляйте ссылку `id` вместо ID голоса
HTTP 400, `invalid JSON request body`	Проверьте кавычки, запятые, скобки и комментарии JSON

HTTP 400 может вернуть code/message/data или объект error. Причина fail_to_fetch_task указана в message, возможно JSON-строке с code/message/request_id. Сохраняйте ID запроса, не передавайте API Key.

Генерация видео Omni

Аутентификация

Тело запроса

Тело ответа

200application/json

400application/json

401application/json

Типы ресурсов и ссылки

Ограничения ресурсов

Частые ошибки и решения

`application/json`

`application/json`

`application/json`