功能简介

添加视频特效到草稿，支持场景特效和人物特效两种类型。特效可以为视频添加各种视觉效果，如光效、粒子、美颜等。

使用场景

• 需要为视频添加场景特效（如光效、粒子等）
• 需要为视频添加人物特效（如美颜、瘦脸等）
• 需要为特定时间段添加特效效果

参数说明

输入参数

基础参数：

参数名	类型	必填	说明
特效名称	字符串	是	特效的名称，通过【获取人物特效类型】指令（人物特效）或【获取场景特效类型】指令（场景特效）来获取
特效类型	字符串	是	特效类型，可选值：scene（场景特效）或character（人物特效），默认scene
特效开始时间	小数	否	特效开始生效的时间，单位：秒，默认0
特效结束时间	小数	否	特效结束的时间，单位：秒，默认3.0
草稿ID	字符串	否	目标草稿的ID，不填则创建新草稿

轨道参数：

参数名	类型	必填	说明
轨道名称	字符串	否	特效所在的轨道名称，默认effect_01。特效是独立的轨道类型，不依附于视频/图片/音频轨道
相对轨道位置	整数	否	轨道相对位置，数值越大越靠上

其他参数：

参数名	类型	必填	说明
特效参数列表	列表	否	特效的额外参数列表，整数列表格式，如[35,45]。不同特效可能有不同的参数要求，未提供的参数将使用默认值
画布宽度	整数	否	草稿画布的宽度，单位：像素。仅在创建新草稿时需要指定
画布高度	整数	否	草稿画布的高度，单位：像素。仅在创建新草稿时需要指定

输出参数

参数名	类型	必填	说明
返回草稿ID	字符串	是	操作后的草稿ID
草稿URL	字符串	是	草稿的访问链接

注意事项

特效名称获取：特效名称必须通过对应的获取接口获取，不能随意填写。人物特效和场景特效的获取接口不同

特效类型匹配：特效名称必须与特效类型匹配，人物特效必须使用【获取人物特效类型】指令获取的名称，场景特效必须使用【获取场景特效类型】指令获取的名称

时间范围：特效开始时间必须小于结束时间，特效会在指定的时间范围内生效

草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID

特效参数：不同特效可能需要不同的参数配置，建议查看特效的具体说明