Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um eine von Klings vordefinierten Effektszenen anzuwenden und die Eingabe-Assets in ein neues kurzes Video umzuwandeln.

Eine Effektszene auswählen

  • Effekte mit einem einzelnen Bild verwenden effect_scene zusammen mit input.image und input.duration
  • Effekte für Interaktionen zwischen zwei Personen verwenden effect_scene zusammen mit input.images mit genau zwei Bildern
  • Eingabebilder müssen die Pixelanforderungen von Kling erfüllen; sehr kleine Thumbnails werden von der Generierungsaufgabe abgelehnt
  • Die genaue Asset-Struktur hängt vom ausgewählten Effekt ab, aber die Anfrage kapselt die Effekt-Einstellungen immer innerhalb von input
  • Verwenden Sie eine Effektszene, die derzeit in Kling verfügbar ist; CometAPI lehnt unbekannte effect_scene-Werte ab
  • Verlassen Sie sich nicht auf eine feste öffentliche Enum-Liste; die Verfügbarkeit von Effekten ändert sich je nach model track und Szenenfamilie

Aufgabenablauf

1

Effektanfrage senden

Senden Sie effect_scene zusammen mit dem passenden input-Objekt und speichern Sie die zurückgegebene Task-ID.
2

Task abfragen

Fahren Sie mit Eine Kling-Task abrufen fort, bis der Effektauftrag abgeschlossen ist.
3

Finales Asset speichern

Laden Sie das fertige Effektvideo herunter oder spiegeln Sie es, wenn Sie eine stabile Aufbewahrung benötigen.
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json
effect_scene
string
erforderlich

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
erforderlich

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.

Antwort

200 - application/json

Task accepted.

code
integer
erforderlich

Error code; specific error code definition

message
string
erforderlich

Error message

data
object
erforderlich