Videoeffekte

Verwenden Sie die Kling Video Effects API über CometAPI, um mit POST /kling/v1/videos/effects stilisierte Effekte auf Videos anzuwenden und Effektparameter zu steuern.

POST /kling/v1/videos/effects

Create a Kling video-effects task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/effects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "effect_scene": "hug",
  "input": {
    "model_name": "kling-v1-6",
    "mode": "std",
    "images": [
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/c54e463c95816d959602f1f2541c62b2.png?x-kcdn-pid=112452",
      "https://p2-kling.klingai.com/bs2/upload-ylab-stunt/5eef15e03a70e1fa80732808a2f50f3f.png?x-kcdn-pid=112452"
    ],
    "duration": "10"
  }
}
'

200

{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "2032273960331935744",
    "task_status": "submitted",
    "task_info": {},
    "created_at": 1773366844624,
    "updated_at": 1773366844624
  }
}

Verwenden Sie diesen Endpunkt, um eine der vordefinierten Effektszenen von Kling anzuwenden und die Eingabe-Assets in ein neues kurzes Video umzuwandeln.

​

Eine Effektszene auswählen

• hug und kiss sind Presets für Interaktionen zwischen zwei Personen
• fuzzyfuzzy, squish, expansion und heart_gesture sind stilisierte Preset-Effekte
• Die genaue Form der Assets hängt vom Effekt ab, aber die Anfrage kapselt anbieterspezifische Einstellungen immer innerhalb von input

​

Aufgabenablauf

1. Effektanfrage übermitteln

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

2. Aufgabe abfragen

   Fahren Sie mit Einzelabfragen 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.

Eine Live-Validierung am 2026-03-13 bestätigte, dass eine hug-Anfrage ohne callback_url oder external_task_id akzeptiert wurde und task_status: submitted zurückgab.

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 · enum<string> · Standard: hug · erforderlich

Preset effect to apply. Each effect defines a specific animation or interaction style.

Verfügbare Optionen: fuzzyfuzzy, squish, expansion, hug, kiss, heart_gesture

input · object · erforderlich

Effect-specific input payload. Most interaction effects use one or more image URLs plus model settings.

Show child attributes

callback_url · string · Standard: https://example.com/webhook

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

external_task_id · string · Standard: my-kling-effect-task-001

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

Show child attributes