
详细每个节点使用说明:
![图片[1]-add_video 添加视频素材 – 剪映助手-爱智特agent,一站式企业智能体推荐平台,扣子企业智能体,扣子工作流免费复制下载](https://img.aiggc.com/wp-content/uploads/2025/07/20250722115228165.png?x-oss-process=style/aiznt)
向指定草稿文件夹中添加视频资源,并支持配置视频的尺寸、位置、时间、速度等参数。
请求参数
参数名 | 类型 | 是否必填 | 默认值 | 说明 |
video_url | String | 是 | – | 视频资源的URL地址 |
start | Number | 否 | 0 | 视频开始时间(秒) |
end | Number | 否 | 9999999 | 视频结束时间(秒,默认极大值表示不限制) |
width | Number | 否 | 1080 | 视频宽度(像素) |
height | Number | 否 | 1920 | 视频高度(像素) |
draft_id | String | 否 | – | 草稿ID(可选,为空表示新建草稿) |
transform_y | Number | 否 | 0 | Y轴平移量(1表示一个画幅高度,正数向下移动) |
scale_x | Number | 否 | 1 | X轴缩放比例 |
scale_y | Number | 否 | 1 | Y轴缩放比例 |
transform_x | Number | 否 | 0 | X轴平移量(1表示一个画幅宽度,正数向右移动) |
speed | Number | 否 | 1.0 | 视频播放速度(1.0为原速) |
target_start | Number | 否 | 0 | 目标开始时间(秒) |
track_name | String | 否 | "main" | 轨道名称(用于多视频混合) |
relative_index | Number | 否 | 0 | 相对索引(用于确定视频在轨道中的顺序,越大越靠前) |
transition | String | 否 | – | 转场名称,支持的转场特效:add_video |
transition_duration | Number | 否 | 0.5 | 转场持续时间 |
mask_type | String | 否 | – | 蒙版类型,支持:<br>"线性" 、"镜面" 、"圆形" 、"矩形" 、"爱心" 、"星形" |
mask_center_x | Number | 否 | 素材中心 | 蒙版中心点 X 坐标(像素单位,以素材左上角为原点) |
mask_center_y | Number | 否 | 素材中心 | 蒙版中心点 Y 坐标(像素单位,以素材左上角为原点) |
mask_size | Number | 否 | 0.5 | 蒙版主要尺寸(占素材高度的比例,如 0.5 表示为素材高度的50%) |
mask_rotation | Number | 否 | 0 | 蒙版顺时针旋转角度(单位:度,如 45 表示旋转45度) |
mask_feather | Number | 否 | 0 | 蒙版羽化值(范围 0~100 ,值越大边缘越模糊) |
mask_invert | Boolean | 否 | false | 是否反转蒙版(true 显示蒙版外区域,false 显示蒙版内区域) |
mask_rect_width | Number | 否 | – | 矩形蒙版宽度(仅当 mask_type="矩形" 时有效,占素材宽度的比例) |
mask_round_corner | Number | 否 | 0 | 矩形蒙版圆角值(仅当 mask_type="矩形" 时有效,范围 0~100 ) |
注意事项
- 坐标系统说明:
- 以视频中心为原点(0,0)
- 实际移动像素计算方式:
- 水平移动像素 =
transform_x
* 视频宽度 - 垂直移动像素 =
transform_y
* 视频高度
- 水平移动像素 =
- 示例:
- 对于1920×1080的视频,
transform_x=0.5
表示向右移动 960 像素 transform_y=-0.8
表示向下移动 864 像素
- 对于1920×1080的视频,
- track_name: 当只有一个视频的时候,轨道名称可以省略,后添加的轨道名默认在更上一层
- relative_index: 轨道渲染顺序索引,默认0,越大越靠上
返回结果
字段 | 类型 | 说明 |
success | boolean | 请求是否成功 |
output | object | 处理结果结构体,包含:draft_id :字符串类型,生成的草稿ID |
error | string | 错误信息(失败时返回,包含帮助链接) |
purchase_link | string | 购买链接(用于错误提示) |
支持的转场特效:
- _3D空间
- 上移
- 下移
- 中心旋转
- 云朵
- 倒影
- 冰雪结晶
- 冲鸭
- 分割
- 分割_II
- 分割_III
- 分割_IV
- 前后对比_II
- 动漫云朵
- 动漫漩涡
- 动漫火焰
- 动漫闪电
- 压缩
- 叠加
- 叠化
- 右移
- 向上
- 向上擦除
- 向下
- 向下擦除
- 向下流动
- 向右
- 向右上
- 向右下
- 向右拉伸
- 向右擦除
- 向右流动
- 向左
- 向左上
- 向左下
- 向左拉伸
- 向左擦除
- 吸入
- 回忆下滑
- 圆形分割_II
- 圆形扫描
- 圆形遮罩
- 圆形遮罩_II
- 复古放映
- 岁月的痕迹
- 左下角_II
- 左移
- 开幕
- 弹幕转场
- 弹跳
- 打板转场_I
- 打板转场_II
- 抖动
- 抖动_II
- 抠像旋转
- 拉伸
- 拉伸_II
- 拉远
- 拍摄器
- 推近
- 撕纸拉屏
- 放射
- 故障
- 斜向分割
- 星星
- 星星_II
- 模糊
- 横向分割
- 横向拉幕
- 横线
- 气泡转场
- 水波卷动
- 水波向右
- 水波向左
- 泛光
- 泛白
- 波点向右
- 渐变擦除
- 滑动
- 漩涡
- 爱心
- 爱心_II
- 爱心上升
- 电视故障_I
- 电视故障_II
- 画笔擦除
- 白光快闪
- 白色墨花
- 白色烟雾
- 百叶窗
- 眨眼
- 矩形分割
- 窗格
- 立方体
- 竖向分割
- 竖向拉幕
- 竖向模糊
- 竖向模糊_II
- 竖线
- 箭头向右
- 粒子
- 翻篇
- 翻页
- 色差逆时针
- 色差顺时针
- 色彩溶解
- 色彩溶解_II
- 色彩溶解_III
- 蓝色线条
- 逆时针旋转
- 逆时针旋转_II
- 镜像翻转
- 闪白
- 闪白_II
- 闪黑
- 雪花故障
- 雾化
- 震动
- 顺时针旋转
- 顺时针旋转_II
- 频闪
- 风车
- 马赛克
- 黑色块
- 黑色烟雾
- 万花筒
- 三屏放大
- 三屏滑入
- 三屏闪切
- 下滑
- 云朵_II
- 亮点模糊
- 便利贴
- 信号故障
- 信号故障_II
- 倾斜拉伸
- 倾斜模糊
- 像素冲屏
- 光束
- 全息投影
- 六边形变焦
- 冲屏扭曲
- 几何分割
- 分屏下滑
- 前后对比
- 剧烈摇晃
- 卡片弹出
- 可爱爆炸
- 吃掉
- 后台切换
- 向上波动
- 向下抖动
- 向下拖拽
- 向左拉屏
- 向左波动
- 喜欢
- 四屏转换
- 回忆
- 回忆_II
- 回忆拉屏
- 回忆拉屏_II
- 圆形分割
- 圣诞树
- 复古叠影
- 复古放映_II
- 复古漏光
- 复古漏光_II
- 复古胶片
- 多层环形
- 多屏定格
- 大圆盘
- 射灯
- 小喇叭
- 小恶魔
- 幻影
- 幻觉
- 开心
- 弹出
- 弹动发光
- 彩色像素
- 微抖动
- 心形叠化
- 快速缩放
- 快门
- 扫光
- 扭曲溶解
- 扭转弹动
- 抖动放大
- 抖动缩小
- 抖动缩小__II
- 抽象前景
- 抽象前景_II
- 拉开
- 拉框入屏
- 拍摄器_II
- 拍摄器_III
- 推近_II
- 推远_II
- 摄像机
- 摇晃描边
- 摇晃震动
- 摇镜
- 撕纸
- 撕纸掉落
- 收缩抖动
- 放大左移
- 放大镜
- 故障模糊
- 数字矩阵
- 斜向模糊
- 斜向闪光
- 斜线翻页
- 新篇章
- 新篇章_II
- 方形分割
- 方形模糊
- 方形模糊_II
- 旋焦
- 旋转圆球
- 旋转圆盘
- 旋转圆盘_II
- 旋转快门
- 旋转拨盘
- 旋转模糊
- 旋转穿越
- 旋转纵深
- 旋转翻页
- 旋转震动
- 无限穿越_I
- 无限穿越_II
- 旧胶片
- 旧胶片_II
- 时光穿梭
- 星光
- 星光叠化
- 星星_III
- 星星吸入
- 星星模糊
- 春日光斑
- 暧昧光晕
- 曝光拉丝
- 曝光摇镜
- 未来光谱
- 未来光谱II
- 条形模糊
- 模糊放大
- 模糊缩小
- 横条挤压
- 横移模糊
- 水墨
- 水滴
- 水滴_II
- 水滴_III
- 汇聚
- 泡泡模糊
- 波光粼粼
- 波动
- 波动_II
- 波动故障
- 流光
- 涂鸦放大
- 溶解推进
- 滑动弹出
- 滑动放大
- 滑块拼贴
- 漩涡扭曲
- 炫光
- 炫光_II
- 炫光_III
- 炫光弹动
- 炫光扫描
- 炸弹
- 烟雾弹
- 热成像
- 燃烧
- 燃烧_II
- 燃烧_III
- 爆米花
- 爆闪
- 爆闪_II
- 爱心冲击
- 爱心模糊
- 爱心气球
- 环形色散
- 玻璃破碎
- 玻璃破碎_II
- 珠光模糊
- 生气
- 电光
- 电光_II
- 百叶窗_II
- 相片切换
- 相片拼贴
- 空间弹动
- 空间弹动_II
- 空间弹动_III
- 空间弹动_IV
- 空间旋转
- 空间旋转_II
- 空间旋转_III
- 空间翻转
- 空间翻转_II
- 空间跳跃
- 穿越
- 穿越_II
- 穿越_III
- 立体翻转
- 立体翻页
- 立体翻页_II
- 竖向拉伸
- 竖移模糊
- 粉色反转片
- 纸团
- 翻转冲屏
- 翻页_II
- 聚光灯
- 胶片定格
- 胶片擦除
- 胶片融化
- 胶片闪光
- 色块故障
- 色差故障
- 色彩溶解_IV
- 色彩溶解_V
- 色散晃镜
- 色散闪烁
- 色散闪烁_II
- 荧光爆闪
- 菱格翻转
- 蓝光扫描
- 蓝色反转片
- 融化
- 融化_II
- 负片下滑
- 超赞
- 透镜故障
- 重叠上滑
- 金色光斑
- 钱兔无量
- 长曝光
- 闪光灯
- 闪光灯_II
- 闪光灯_III
- 闪动光斑
- 闪动光斑_II
- 闪回
- 闪屏故障
- 闪黑_II
- 闹钟
- 雪雾
- 震动_II
- 震动缩小
- 霓虹闪光
- 霓虹闪光_II
- 飘雪
- 飘雪_II
- 马赛克_II
- 鱼眼
- 鱼眼_II
- 鱼眼_III
- 黑白摇镜
- 黑色反转片
© 版权声明
AI智能体所有文章,如无特殊说明或标注,均为本站作者原创发布。任何个人或组织,在未征得作者同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若此作者内容侵犯了原著者的合法权益,可联系客服处理。
THE END
暂无评论内容