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; доступність ефектів змінюється залежно від гілки model та сімейства сцен

Потік завдання

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
обов'язково