Skip to main content
POST
cURL
Используйте этот endpoint, чтобы применить одну из предустановленных сцен эффектов Kling и превратить входные материалы в новое короткое видео.

Выберите сцену эффекта

  • Эффекты для одного изображения используют effect_scene вместе с input.image и input.duration
  • Эффекты взаимодействия двух персонажей используют effect_scene вместе с input.images, содержащим ровно два изображения
  • Входные изображения должны соответствовать требованиям Kling к пикселям; слишком маленькие миниатюры отклоняются задачей генерации
  • Точная структура материалов зависит от выбранного эффекта, но запрос всегда включает настройки эффекта внутри input
  • Используйте сцену эффекта, которая в данный момент доступна в Kling; CometAPI отклоняет неизвестные значения effect_scene
  • Не полагайтесь на фиксированный публичный список enum-значений; доступность эффектов меняется в зависимости от линейки модели и семейства сцен

Процесс задачи

1

Отправьте запрос на эффект

Отправьте effect_scene вместе с соответствующим объектом input и сохраните возвращённый id задачи.
2

Опрашивайте задачу

Продолжайте с Получение задачи Kling, пока задача эффекта не завершится.
3

Сохраните итоговый материал

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

Авторизации

Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Тело

application/json
effect_scene
string
обязательно

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
обязательно

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Ответ

200 - application/json

Task accepted.

code
integer
обязательно

Error code; specific error code definition

message
string
обязательно

Error message

data
object
обязательно