添加特效
功能简介
添加视频特效到草稿，支持场景特效和人物特效两种类型。特效可以为视频添加各种视觉效果，如光效、粒子、美颜等。
使用场景
- 需要为视频添加场景特效（如光效、粒子等）
- 需要为视频添加人物特效（如美颜、瘦脸等）
- 需要为特定时间段添加特效效果
参数说明
输入参数
基础参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 特效名称 | 字符串 | 是 | 特效的名称，通过【获取人物特效类型】指令（人物特效）或【获取场景特效类型】指令（场景特效）来获取 |
| 特效类型 | 字符串 | 是 | 特效类型，可选值：scene（场景特效）或character（人物特效），默认scene |
| 特效开始时间 | 小数 | 否 | 特效开始生效的时间，单位：秒，默认0 |
| 特效结束时间 | 小数 | 否 | 特效结束的时间，单位：秒，默认3.0 |
| 草稿ID | 字符串 | 否 | 目标草稿的ID，不填则创建新草稿 |
轨道参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 轨道名称 | 字符串 | 否 | 特效所在的轨道名称，默认effect_01。特效是独立的轨道类型，不依附于视频/图片/音频轨道 |
| 相对轨道位置 | 整数 | 否 | 轨道相对位置，数值越大越靠上 |
其他参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 特效参数列表 | 列表 | 否 | 特效的额外参数列表，整数列表格式，如[35,45]。不同特效可能有不同的参数要求，未提供的参数将使用默认值 |
| 画布宽度 | 整数 | 否 | 草稿画布的宽度，单位：像素。仅在创建新草稿时需要指定 |
| 画布高度 | 整数 | 否 | 草稿画布的高度，单位：像素。仅在创建新草稿时需要指定 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 返回草稿ID | 字符串 | 是 | 操作后的草稿ID |
| 草稿URL | 字符串 | 是 | 草稿的访问链接 |
注意事项
特效名称获取：特效名称必须通过对应的获取接口获取，不能随意填写。人物特效和场景特效的获取接口不同
特效类型匹配：特效名称必须与特效类型匹配，人物特效必须使用【获取人物特效类型】指令获取的名称，场景特效必须使用【获取场景特效类型】指令获取的名称
时间范围：特效开始时间必须小于结束时间，特效会在指定的时间范围内生效
草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID
特效参数：不同特效可能需要不同的参数配置，建议查看特效的具体说明