> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xuwuai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 视频特效

> 透传可灵官方视频特效任务；成功后按 final_unit_deduction 积分结算

* 路径 `POST /kling/v1/videos/effects`
* 与官网一致：请求体按可灵官方字段透传，创建响应保留上游 `task_id` 并追加平台 `platform_id`
* 计费：成功任务按上游终态 `final_unit_deduction` 结算到 `kling-video-points`

请求参数

| 参数                 | 类型     | 必填    | 说明                                                                           |
| ------------------ | ------ | ----- | ---------------------------------------------------------------------------- |
| `model_name`       | string | 否     | 可选：`kling-v1-6`、`kling-v2-1`、`kling-v3`、`kling-v3-omni`；未传时按 `kling-v1-6` 路由 |
| `effect_scene`     | string | **是** | 官方视频特效场景                                                                     |
| `image`            | string | 否     | 参考图片 URL 或 Base64，按官方场景要求传入                                                  |
| `video`            | string | 否     | 参考视频 URL 或 Base64，按官方场景要求传入                                                  |
| `callback_url`     | string | 否     | 回调通知地址                                                                       |
| `external_task_id` | string | 否     | 自定义任务 ID                                                                     |

示例

```bash theme={null}
curl --request POST \
  --url https://xuwuai.com/kling/v1/videos/effects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v3",
    "effect_scene": "rocketrocket",
    "image": "https://example.com/ref.png",
    "external_task_id": "effects-demo-001"
  }'
```

任务查询

```bash theme={null}
curl "https://xuwuai.com/kling/v1/videos/effects/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"
```