# 视频特效

**方法**: `POST`
**路径**: `/kling/v1/videos/effects`

您可以根据 effect\_scene 实现不同的特效效果，现支持：
● 单图特效：快来惹毛我fuzzyfuzzy、捏捏乐squish、万物膨胀expansion
双人互动特效： 3款，拥抱hug、亲吻kiss、比心heart\_gesture

具体参数请看官方文档：<https://docs.qingque.cn/d/home/eZQClW07IFEuX1csc-VejdY2M?identityId=1oEG9JKKMFv#section=h.jf1wj61w4jyf>
对接时，仅需将请求域名、API key 改成我们，

## 请求参数

### Header 参数

```text
Content-Type
string
必需
示例:
application/json
Authorization
string
可选
默认值:
Bearer {{YOUR_API_KEY}}
```

### Body 参数 application/json

```text
effect_scene
string
必需
input
object
必需
model_name
string
必需
mode
string
必需
images
array
[string]
必需
duration
string
必需
示例
{
"effect_scene"
:
"string"
,
"input"
:
{
"model_name"
:
"string"
,
"mode"
:
"string"
,
"images"
:
[
"string"
]
,
"duration"
:
"string"
}
}
```

## 请求示例代码

### Shell

```bash
curl --location --request POST '/kling/v1/videos/effects' \
--header 'Authorization: Bearer {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "effect_scene": "string",
    "input": {
        "model_name": "string",
        "mode": "string",
        "images": [
            "string"
        ],
        "duration": "string"
    }
}'
```

## 返回响应

### 🟢 200 成功

**内容类型**: `application/json`

#### 响应结构

```text
object
```

#### 示例

```json
{
    "code": 0,
    "message": "SUCCEED",
    "request_id": "CmJ8DGePZioAAAAAAFIvOQ",
    "data": {
        "task_id": "CmJ8DGePZioAAAAAAFIvOQ",
        "task_status": "submitted",
        "created_at": 1737628288136,
        "updated_at": 1737628288136
    }
}
```