Генерация видео Kling v4 Flash

POST

/v1/videos/generations

Все три режима используют kling-4.0-flash. Путь генерации выбирается по переданным материалам. API асинхронный; после отправки запрашивайте результат по ID задачи платформы.

Используйте API-ключ платформы. В материковом Китае можно заменить https://toapis.com на https://toapis.cn. Доступность зависит от развернутой конфигурации канала и прав аккаунта.

Режимы ввода

Режим	Содержимое запроса
Текст в видео	Передайте текст и параметры результата без медиа.
Референсы	Используйте `image_urls` / `video_urls` или материалы с reference-ролями. Изображения и видео можно сочетать.
Начальный кадр	Задайте одно изображение `first_frame` в `image_with_roles`. Не добавляйте референсные изображения или видео; промежуточные и конечные кадры не поддерживаются.

Параметры запроса

Authorizationstringзаголовокобязательно

Авторизация: Bearer YOUR_API_KEY.

modelstringтелообязательно

Всегда kling-4.0-flash. Не меняйте ID модели при переключении режима.

promptstringтелообязательно

Обязательный непустой текст, до 8000 символов Unicode. Опишите субъект, движение, камеру и связь между материалами.

durationintegerтелопо умолчанию: 5

Целое число от 3 до 20 секунд. По умолчанию 5.

resolutionstringтелопо умолчанию: 720p

Только 720p. По умолчанию 720p.

aspect_ratiostringтело

auto, 16:9, 9:16, 1:1, 21:9. При отсутствии сохраняется значение провайдера; для автоматического соотношения можно явно передать auto.

image_urlsstring[]тело

Массив URL референсных изображений, до 10. Позиция не означает начальный кадр. Количество суммируется с reference-ролями; не дублируйте материалы.

video_urlsstring[]тело

Массив URL референсных видео, до 5 вместе с video_with_roles.

image_with_rolesobject[]тело

Поля объекта: url и role. reference / reference_image обозначают референс, first_frame обозначает начальный кадр. keyframe и last_frame не поддерживаются.

video_with_rolesobject[]тело

Поля объекта: url и role. Поддерживаются reference / reference_video.

metadataobjectтело

Логическое поле keep_original_sound сохраняет звук референсного видео, например {"keep_original_sound": true}. Только для референсного видео. В режиме начального кадра запрещено даже значение false.

client_business_idstringтело

Необязательный бизнес-ID клиента, сохраняется в задаче и поддерживается тем же API статуса.

Правила материалов и валидация

Используйте общедоступные HTTP(S) URL без имени пользователя и пароля. Локальные файлы сначала загрузите через загрузку изображений или видео. Не передавайте локальные пути или base64.
Режим референсов допускает до 10 изображений и 5 видео. Обычные массивы и явные reference-роли суммируются; не отправляйте один материал дважды.
Режим начального кадра принимает ровно одно изображение first_frame; роли keyframe и last_frame отклоняются. Начальный кадр определяется ролью, а не позицией обычного изображения.
Начальный кадр несовместим с референсами. Не используйте старые Kling mode, audio, video_list и структуры Omni. audio_with_roles, metadata.elements, metadata.voices не поддерживаются.
Недопустимые параметры, роли, URL, количества и сочетания режимов отклоняются. Исправьте ошибку перед повторной отправкой. Страница не гарантирует пределы размера, кодеков или длины входного видео; учитывайте требования загрузки и провайдера.

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

Текст в видео

{
  "model": "kling-4.0-flash",
  "prompt": "Волны у берега, плавное приближение камеры, закатный свет",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}

Референсы

{
  "model": "kling-4.0-flash",
  "prompt": "Сохранить персонажа с изображения и движение камеры из референсного видео",
  "duration": 10,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_urls": [
    "https://example.com/character.png"
  ],
  "video_urls": [
    "https://example.com/motion.mp4"
  ],
  "metadata": {
    "keep_original_sound": true
  }
}

Начальный кадр

{
  "model": "kling-4.0-flash",
  "prompt": "Начиная с первого кадра, персонаж медленно поворачивается к окну",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9",
  "image_with_roles": [
    {
      "url": "https://example.com/first.png",
      "role": "first_frame"
    }
  ]
}

Отправка задачи

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

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "kling-4.0-flash",
  "prompt": "Волны у берега, плавное приближение камеры, закатный свет",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16:9"
}'

Пример ответа

{
  "id": "task_example",
  "object": "generation.task",
  "model": "kling-4.0-flash",
  "status": "queued",
  "created_at": 1792713600
}

Статус задачи и оплата

Поле id ответа является ID задачи платформы. Используйте API ниже вместо task_id провайдера. Статусы: queued, in_progress, completed, failed. См. статус видео и Webhook задач.

curl --request GET \
  --url https://toapis.com/v1/videos/generations/YOUR_TASK_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

По умолчанию 5 секунд / 720p. Явно задавайте параметры для контроля результата. Фиксированные цены и соответствие сохранения звука старому тарифу Sound не обещаются. Оплата определяется котировкой аккаунта и полями usage / billing задачи.