主题
添加滤镜
给草稿中的视频画面添加滤镜效果。
请求
POST /api/add_filter
接口说明
给草稿添加滤镜并设置生效区间和强度。滤镜名称先用 get_filter_types 查询,intensity 范围是 0-100。
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
filter_type | string | 是 | - | 滤镜类型名称,可通过 get_filter_types 查询 |
start | number | 否 | 0 | 开始时间,单位秒 |
end | number | 否 | 3.0 | 结束时间,单位秒 |
intensity | number | 否 | 100.0 | 滤镜强度,范围 0-100 |
draft_id | string | 否 | - | 草稿 ID,不传则创建新草稿 |
track_name | string | 否 | filter_01 | 滤镜轨道名称 |
width | integer | 否 | 1080 | 草稿宽度 |
height | integer | 否 | 1920 | 草稿高度 |
示例
bash
curl -X POST https://your-domain.example/api/add_filter \
-H "Content-Type: application/json" \
-H "X-API-Key: $VECTCUT_API_KEY" \
-d '{
"draft_id": "dfd_cat_demo_001",
"filter_type": "_1980",
"start": 0,
"end": 5,
"intensity": 80
}'返回
json
{
"success": true,
"output": {
"draft_id": "dfd_cat_demo_001",
"draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001"
},
"error": ""
}