添加图片
功能简介
添加图片素材到草稿，支持图片的位置调整、缩放、旋转、动画效果、转场、蒙版等多种功能。可以为视频添加图片元素或制作图片轮播效果。
使用场景
- 需要将图片添加到剪辑项目中
- 需要制作图片轮播视频
- 需要为视频添加图片装饰
- 需要调整图片的位置、大小和显示效果
参数说明
输入参数
基础参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 图片路径或URL | 字符串 | 是 | 图片文件的网络URL或本地文件路径。支持两种方式： 1. 网络URL：直接提供可访问的图片链接 2. 本地路径：提供本地图片文件的绝对路径或相对路径，系统会自动上传（最大100MB） |
| 开始时间 | 小数 | 否 | 图片开始显示的时间，单位：秒，默认0 |
| 结束时间 | 小数 | 是 | 图片结束显示的时间，单位：秒 |
| 草稿ID | 字符串 | 否 | 目标草稿的ID，不填则创建新草稿 |
位置和缩放参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 水平偏移 | 小数 | 否 | 水平方向的偏移（相对值），单位为半个画布宽，范围-1.0到1.0 |
| 水平偏移_像素 | 整数 | 否 | 水平方向的偏移（像素值），单位：像素 |
| 垂直偏移 | 小数 | 否 | 垂直方向的偏移（相对值），单位为半个画布高，范围-1.0到1.0 |
| 垂直偏移_像素 | 整数 | 否 | 垂直方向的偏移（像素值），单位：像素 |
| 水平缩放 | 小数 | 否 | 水平方向的缩放比例，1.0为原始大小 |
| 垂直缩放 | 小数 | 否 | 垂直方向的缩放比例，1.0为原始大小 |
| 旋转角度 | 小数 | 否 | 图片的旋转角度，单位：度 |
动画参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 入场动画名 | 字符串 | 否 | 入场动画名称，通过【获取入场动画类型】指令来获取 |
| 入场动画时长 | 小数 | 否 | 入场动画的持续时间，单位：秒 |
| 出场动画名 | 字符串 | 否 | 出场动画名称，通过【获取出场动画类型】指令来获取 |
| 出场动画时长 | 小数 | 否 | 出场动画的持续时间，单位：秒 |
| 组合动画名 | 字符串 | 否 | 组合动画名称，通过【获取组合动画类型】指令来获取 |
| 组合动画时长 | 小数 | 否 | 组合动画的持续时间，单位：秒 |
其他参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 轨道名称 | 字符串 | 否 | 图片所在的轨道名称，默认image_main。设置为main则位于主轨道 |
| 轨道相对位置 | 整数 | 否 | 轨道相对位置，数值越大越靠上 |
| 转场动画 | 字符串 | 否 | 转场动画名称，通过【获取转场类型】指令来获取 |
| 转场动画时长 | 小数 | 否 | 转场动画的持续时间，单位：秒 |
| 蒙版类型 | 字符串 | 否 | 蒙版类型名称，通过【获取蒙版类型】指令来获取 |
| 透明度 | 小数 | 否 | 图片透明度，范围0.0-1.0，1.0为完全不透明（默认值），0.0为完全透明 |
| 是否镜像反转 | 布尔值 | 否 | 是否水平镜像反转图片 |
| 背景模糊 | 整数 | 否 | 背景模糊程度，1轻/2中/3强/4最强 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 返回草稿ID | 字符串 | 是 | 操作后的草稿ID |
| 草稿URL | 字符串 | 是 | 草稿的访问链接 |
注意事项
警告
图片路径或URL：
- 网络URL：必须是可公开访问的链接，不能是私有链接或需要认证的链接
- 本地文件：支持绝对路径和相对路径，文件大小最大100MB
- 本地文件会自动上传到临时图床，上传后的URL有效期根据图床服务而定
时间参数：开始时间必须小于结束时间，图片会在指定的时间范围内显示
偏移参数：相对值和像素值只需设置其中一个，如果都设置，像素值优先级更高
动画效果：可以同时设置入场动画、出场动画和组合动画，实现丰富的视觉效果
草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID
使用示例
使用网络URL：
python
图片路径或URL = "（填写可公网访问的图片地址）"使用本地文件路径：
python
图片路径或URL = "/Users/username/Pictures/image.jpg"
# 或相对路径
图片路径或URL = "./images/image.jpg"