add_video 添加视频素材 – 剪映助手

爱智特-AI智能体一站式企业智能体交易学习发行平台|智能体教程|智能体社区

详细每个节点使用说明:

图片[1]-add_video 添加视频素材 – 剪映助手-爱智特agent,一站式企业智能体推荐平台,扣子企业智能体,扣子工作流免费复制下载

向指定草稿文件夹中添加视频资源,并支持配置视频的尺寸、位置、时间、速度等参数。

请求参数

参数名类型是否必填默认值说明
video_urlString视频资源的URL地址
startNumber0视频开始时间(秒)
endNumber9999999视频结束时间(秒,默认极大值表示不限制)
widthNumber1080视频宽度(像素)
heightNumber1920视频高度(像素)
draft_idString草稿ID(可选,为空表示新建草稿)
transform_yNumber0Y轴平移量(1表示一个画幅高度,正数向下移动)
scale_xNumber1X轴缩放比例
scale_yNumber1Y轴缩放比例
transform_xNumber0X轴平移量(1表示一个画幅宽度,正数向右移动)
speedNumber1.0视频播放速度(1.0为原速)
target_startNumber0目标开始时间(秒)
track_nameString"main"轨道名称(用于多视频混合)
relative_indexNumber0相对索引(用于确定视频在轨道中的顺序,越大越靠前)
transitionString转场名称,支持的转场特效:add_video
transition_durationNumber0.5转场持续时间
mask_typeString蒙版类型,支持:<br>"线性""镜面""圆形""矩形""爱心""星形"
mask_center_xNumber素材中心蒙版中心点 X 坐标(像素单位,以素材左上角为原点)
mask_center_yNumber素材中心蒙版中心点 Y 坐标(像素单位,以素材左上角为原点)
mask_sizeNumber0.5蒙版主要尺寸(占素材高度的比例,如 0.5 表示为素材高度的50%)
mask_rotationNumber0蒙版顺时针旋转角度(单位:度,如 45 表示旋转45度)
mask_featherNumber0蒙版羽化值(范围 0~100,值越大边缘越模糊)
mask_invertBooleanfalse是否反转蒙版(true 显示蒙版外区域,false 显示蒙版内区域)
mask_rect_widthNumber矩形蒙版宽度(仅当 mask_type="矩形" 时有效,占素材宽度的比例)
mask_round_cornerNumber0矩形蒙版圆角值(仅当 mask_type="矩形" 时有效,范围 0~100

注意事项

  1. 坐标系统说明
    1. 以视频中心为原点(0,0)
    2. 实际移动像素计算方式
      • 水平移动像素 = transform_x * 视频宽度
      • 垂直移动像素 = transform_y * 视频高度
    3. 示例:
      • 对于1920×1080的视频,transform_x=0.5 表示向右移动 960 像素
      • transform_y=-0.8 表示向下移动 864 像素
  2. track_name: 当只有一个视频的时候,轨道名称可以省略,后添加的轨道名默认在更上一层
  3. relative_index: 轨道渲染顺序索引,默认0,越大越靠上

返回结果

字段类型说明
successboolean请求是否成功
outputobject处理结果结构体,包含:draft_id:字符串类型,生成的草稿ID
errorstring错误信息(失败时返回,包含帮助链接)
purchase_linkstring购买链接(用于错误提示)

支持的转场特效:

  • _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
  • 黑白摇镜
  • 黑色反转片
© 版权声明
THE END
喜欢就支持一下吧
点赞6 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容