Skip to main content
POST
cURL
Użyj tego endpointu, aby zastosować jedną z predefiniowanych scen efektów Kling i przekształcić zasoby wejściowe w nowy krótki film.

Wybierz scenę efektu

  • Efekty dla pojedynczego obrazu używają effect_scene oraz input.image i input.duration
  • Efekty interakcji dwóch osób używają effect_scene oraz input.images z dokładnie dwoma obrazami
  • Obrazy wejściowe muszą spełniać wymagania Kling dotyczące pikseli; małe miniatury są odrzucane przez zadanie generowania
  • Dokładna forma zasobów zależy od wybranego efektu, ale żądanie zawsze zawiera ustawienia efektu wewnątrz input
  • Użyj sceny efektu, która jest obecnie dostępna w Kling; CometAPI odrzuca nieznane wartości effect_scene
  • Unikaj polegania na stałej publicznej liście enum; dostępność efektów zmienia się w zależności od ścieżki modelu i rodziny scen

Przebieg zadania

1

Wyślij żądanie efektu

Wyślij effect_scene wraz z pasującym obiektem input i zapisz zwrócone id zadania.
2

Odpytuj zadanie

Kontynuuj z Pobierz zadanie Kling, aż zadanie efektu się zakończy.
3

Zachowaj końcowy zasób

Pobierz lub skopiuj gotowy film z efektem, jeśli potrzebujesz trwałego przechowywania.
Pełne odniesienie do parametrów znajdziesz w oficjalnej dokumentacji Kling.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
effect_scene
string
wymagane

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
wymagane

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.

Odpowiedź

200 - application/json

Task accepted.

code
integer
wymagane

Error code; specific error code definition

message
string
wymagane

Error message

data
object
wymagane