add_effect

POST /add_effect

接口说明

向草稿添加场景特效或人物特效，并设置生效区间、轨道和可选参数。特效名称必须先通过 get_video_scene_effect_types 或 get_video_character_effect_types 查询。

请求参数

参数	必填	默认值	说明
effect_type	是	—	特效名称
start	否	0	源素材开始时间，单位秒
effect_category	否	'scene'	特效分类，scene 或 character
end	否	3.0	源素材结束时间，单位秒
draft_id	是	—	草稿 ID，创建草稿后获得
track_name	否	'effect_01'	目标轨道名称
params	是	—	特效参数列表；不传时使用默认值
width	否	1080	画布或素材宽度
height	否	1920	画布或素材高度

调用示例

curl -X POST https://your-domain.example/api/add_effect \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "effect_type": "_1998",
    "effect_category": "scene",
    "start": 0,
    "end": 3,
    "params": []
  }'

返回格式

{
  "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": ""
}