Video Effects

Use the Kling Video Effects API via CometAPI to apply stylized effects to videos with POST /kling/v1/videos/effects and control effect parameters.

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
  }
}

Use this endpoint to apply one of Kling’s preset effect scenes and turn the input assets into a new short video.

Choose an effect scene

• hug and kiss are two-person interaction presets
• fuzzyfuzzy, squish, expansion, and heart_gesture are stylized preset effects
• The exact asset shape depends on the effect, but the request always wraps provider-specific settings inside input

Task flow

1. Submit the effect request

   Send effect_scene plus the matching input object and store the returned task id.

2. Poll the task

   Continue with Individual Queries until the effect job finishes.

3. Persist the final asset

   Download or mirror the finished effect video if you need stable retention.

Live validation on 2026-03-13 confirmed that a hug request was accepted without callback_url or external_task_id and returned task_status: submitted.

For the complete parameter reference, see the official Kling documentation.

Authorizations

Authorization · string · header · required

Bearer token authentication. Use your CometAPI key.

Body

application/json

effect_scene · enum<string> · default: hug · required

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

Available options: fuzzyfuzzy, squish, expansion, hug, kiss, heart_gesture

input · object · required

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

Show child attributes

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

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

external_task_id · string · default: 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.

Response

200 - application/json

Task accepted.

code · integer · required

Error code; specific error code definition

message · string · required

Error message

data · object · required

Show child attributes