功能简介
添加视频素材到草稿，支持视频的裁剪、缩放、位置调整、转场效果、蒙版等多种功能。是视频剪辑的核心功能之一。
使用场景
- 需要将视频素材添加到剪辑项目中
- 需要裁剪视频的特定片段
- 需要调整视频的位置、大小和播放速度
- 需要为视频添加转场效果或蒙版
参数说明
输入参数
基础参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 视频路径或URL | 字符串 | 是 | 视频文件的网络URL或本地文件路径。支持两种方式： 1. 网络URL：直接提供可访问的视频链接 2. 本地路径：提供本地视频文件的绝对路径或相对路径，系统会自动上传（最大100MB） |
| 起始截取时间 | 小数 | 否 | 从视频的哪个时间点开始截取，单位：秒，默认0表示从头开始 |
| 结束截取时间 | 小数 | 否 | 截取到视频的哪个时间点，单位：秒。不填表示截取到视频结尾 |
| 起始位置 | 小数 | 否 | 视频在时间线上的起始位置，单位：秒，默认0表示从开头开始 |
| 草稿ID | 字符串 | 否 | 目标草稿的ID，不填则创建新草稿 |
位置和缩放参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 垂直偏移 | 小数 | 否 | 垂直方向的偏移（相对值），单位为半个画布高，范围-1.0到1.0，默认0表示居中 |
| 垂直偏移_像素 | 整数 | 否 | 垂直方向的偏移（像素值），单位：像素 |
| 水平偏移 | 小数 | 否 | 水平方向的偏移（相对值），单位为半个画布宽，范围-1.0到1.0，默认0表示居中 |
| 水平偏移_像素 | 整数 | 否 | 水平方向的偏移（像素值），单位：像素 |
| 水平缩放 | 小数 | 否 | 水平方向的缩放比例，1.0为原始大小，默认1 |
| 垂直缩放 | 小数 | 否 | 垂直方向的缩放比例，1.0为原始大小，默认1 |
其他参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 视频播放速度 | 小数 | 否 | 视频播放速度，1.0为正常速度，大于1.0为快放，小于1.0为慢放 |
| 轨道名称 | 字符串 | 否 | 视频所在的轨道名称，默认video_main。设置为main则位于主轨道 |
| 轨道相对位置 | 整数 | 否 | 轨道相对位置，数值越大越靠上 |
| 素材时长 | 小数 | 否 | 视频的原始时长，单位：秒。提供此参数可跳过自动检测，提高处理速度 |
| 转场动画 | 字符串 | 否 | 转场动画名称，通过【获取转场类型】指令来获取 |
| 转场动画时长 | 小数 | 否 | 转场动画的持续时间，单位：秒，默认0.5 |
| 音量 | 小数 | 否 | 视频音量，单位：db，0.0为原始音量，-100为静音 |
| 蒙版类型 | 字符串 | 否 | 蒙版类型名称，通过【获取蒙版类型】指令来获取 |
| 透明度 | 小数 | 否 | 视频透明度，范围0.0-1.0，1.0为完全不透明（默认值），0.0为完全透明 |
| 镜像反转 | 布尔值 | 否 | 是否水平镜像反转视频 |
| 混合模式 | 字符串 | 否 | 混合模式，目前只支持"正片叠底" |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 返回草稿ID | 字符串 | 是 | 操作后的草稿ID |
| 草稿URL | 字符串 | 是 | 草稿的访问链接 |
注意事项
视频路径或URL：
- 网络URL：必须是可公开访问的链接，不能是私有链接或需要认证的链接
- 本地文件：支持绝对路径和相对路径，文件大小最大100MB
- 本地文件会自动上传到临时图床，上传后的URL有效期根据图床服务而定
时间参数：起始截取时间必须小于结束截取时间，且不能超过视频的实际时长
偏移参数：相对值和像素值只需设置其中一个，如果都设置，像素值优先级更高
草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID
使用示例
使用网络URL：
python
视频路径或URL = "（填写可公网访问的视频地址）"使用本地文件路径：
python
视频路径或URL = "/Users/username/Videos/video.mp4"
# 或相对路径
视频路径或URL = "./videos/video.mp4"