Sign in

v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Kling video-effects task

Submit an effect_scene plus a provider-specific input object. callback_url and external_task_id are optional.

post/kling/v1/videos/effects

Request body

effect_scenestring required

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

callback_urlstring

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

external_task_idstring

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Response

Task accepted.

codeinteger required

Error code; specific error code definition

messagestring required

Error message

Example response

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