> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kapon.cloud/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://models.kapon.cloud/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://models.kapon.cloud/kling/v1/videos/effects/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"
```


## OpenAPI

````yaml POST /kling/v1/videos/effects
openapi: 3.0.3
info:
  title: Kling API
  version: '2026-09-07'
  description: API 2.0 与 Legacy 分开定义；请求使用 Kapon Token。
servers:
  - url: https://models.kapon.cloud
security:
  - BearerAuth: []
paths:
  /kling/v1/videos/effects:
    post:
      tags:
        - Kling
      summary: Video effects
      description: >-
        透传官方 /v1/videos/effects 请求体；创建响应保留上游 task_id 并追加 platform_id。成功任务按
        final_unit_deduction 结算到 kling-video-points，真实点值需以任务终态为准。
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      security:
        - BearerAuth: []
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````