视频特效

通过 CometAPI 使用 Kling 视频特效 API，调用 POST /kling/v1/videos/effects 为视频应用风格化特效并控制特效参数。

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

使用此端点可应用 Kling 的预设特效场景之一，并将输入素材转换为一个新的视频短片。

​

选择特效场景

• hug 和 kiss 是双人互动预设
• fuzzyfuzzy、squish、expansion 和 heart_gesture 是风格化预设特效
• 具体素材格式取决于特效类型，但请求始终会将提供方特定的设置封装在 input 中

​

任务流程

1. 提交特效请求

   发送 effect_scene 以及匹配的 input 对象，并保存返回的任务 id。

2. 轮询任务

   继续使用单项查询，直到特效任务完成。

3. 保存最终素材

   如果你需要稳定保留结果，请下载或镜像已完成的特效视频。

在 2026-03-13 的实时验证中，已确认 hug 请求在不提供 callback_url 或 external_task_id 的情况下也可被接受，并返回 task_status: submitted。

完整参数说明请参阅官方 Kling 文档。

授权

Authorization · string · header · 必填

Bearer token authentication. Use your CometAPI key.

请求体

application/json

effect_scene · enum<string> · 默认值: hug · 必填

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

可用选项: fuzzyfuzzy, squish, expansion, hug, kiss, heart_gesture

input · object · 必填

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

Show child attributes

callback_url · string · 默认值: https://example.com/webhook

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

external_task_id · string · 默认值: 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.

响应

200 - application/json

Task accepted.

code · integer · 必填

Error code; specific error code definition

message · string · 必填

Error message

data · object · 必填

Show child attributes