Skip to main content
POST
/
kling
/
v1
/
videos
/
effects
cURL
curl https://api.cometapi.com/kling/v1/videos/effects \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
      "effect_scene": "hug",
      "input": {
        "mode": "std",
        "images": [
          "https://your-image-host/person-a.jpg",
          "https://your-image-host/person-b.jpg"
        ],
        "duration": "5"
      }
    }'
{
  "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

  • Single-image effects use effect_scene plus input.image and input.duration
  • Two-person interaction effects use effect_scene plus input.images with exactly two images
  • Input images must meet Kling pixel requirements; tiny thumbnails are rejected by the generation task
  • The exact asset shape depends on the selected effect, but the request always wraps effect settings inside input
  • Use an effect scene that is currently available in Kling; CometAPI rejects unknown effect_scene values
  • Avoid relying on a fixed public enum list; effect availability changes by model track and scene family

​
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 Get a Kling task until the effect job finishes.
3

Persist the final asset

Download or mirror the finished effect video if you need stable retention.
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
string
required

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
required

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.

Response

200 - application/json

Task accepted.

​
code
integer
required

Error code; specific error code definition

​
message
string
required

Error message

​
data
object
required