添加滤镜
功能简介
添加滤镜效果到草稿，为视频添加特定的色彩风格和视觉效果。滤镜可以改变视频的整体色调和氛围。
使用场景
- 需要为视频添加特定的色彩风格
- 调整视频的整体色调和氛围
- 批量为多个视频片段添加相同滤镜
参数说明
输入参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 滤镜类型名称 | 字符串 | 是 | 滤镜的名称，通过【获取滤镜类型】指令来获取可用滤镜列表 |
| 开始时间 | 小数 | 是 | 滤镜开始生效的时间，单位：秒 |
| 结束时间 | 小数 | 是 | 滤镜结束的时间，单位：秒 |
| 草稿ID | 字符串 | 否 | 目标草稿的ID，不填则创建新草稿 |
| 轨道名 | 字符串 | 否 | 滤镜所在的轨道名称 |
| 相对轨道位置 | 整数 | 否 | 轨道相对位置，数值越大越靠上 |
| 滤镜强度 | 小数 | 否 | 滤镜的强度，范围0-100，默认100表示最强效果 |
| 画布宽度 | 整数 | 否 | 草稿画布的宽度，单位：像素 |
| 画布高度 | 整数 | 否 | 草稿画布的高度，单位：像素 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 返回草稿ID | 字符串 | 是 | 操作后的草稿ID |
| 草稿URL | 字符串 | 是 | 草稿的访问链接 |
注意事项
警告
- 滤镜名称获取：滤镜类型名称必须通过【获取滤镜类型】指令来获取，不能随意填写。
- 时间范围：开始时间必须小于结束时间，滤镜会在指定的时间范围内生效。
- 滤镜强度：强度值越大，滤镜效果越明显。0表示无效果，100表示最强效果。
- 草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID。