add_sticker 添加贴纸 – 剪映助手

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

详细每个节点使用说明:

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

向指定草稿添加贴纸资源,并配置贴纸的显示参数(位置、大小、透明度等)。

请求参数

参数名类型是否必填默认值说明
sticker_idString贴纸资源ID(需通过 /search_sticker 接口获取)
draft_idString目标草稿ID,如果为空则表示创建一个新的草稿
startNumber0贴纸显示的起始时间(秒)
endNumber5.0贴纸显示的结束时间(秒,默认5秒)
transform_xNumber0X轴平移量(1表示一个画幅宽度,正数向右移动)
transform_yNumber0Y轴平移量(1表示一个画幅高度,正数向下移动)
alphaNumber1.0透明度(0.0完全透明,1.0完全不透明)
flip_horizontalBooleanFalse是否水平翻转
flip_verticalBooleanFalse是否垂直翻转
rotationNumber0.0旋转角度(顺时针,单位:度)
scale_xNumber1.0X轴缩放比例(如 0.5 表示缩小50%)
scale_yNumber1.0Y轴缩放比例
track_nameString"sticker_main"轨道名称(贴纸所在轨道,用于图层管理)
relative_indexNumber0轨道内相对索引,越大越靠前
widthNumber1080视频宽度(像素)
heightNumber1920视频高度(像素)

返回结果

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

注意事项

  1. 坐标系统说明
    1. 以视频中心为原点(0,0)
    2. 实际移动像素计算方式
      • 水平移动像素 = transform_x * 视频宽度
      • 垂直移动像素 = transform_y * 视频高度
    3. 示例:
      • 对于1920×1080的视频,transform_x=0.5 表示向右移动 960 像素
      • transform_y=-0.8 表示向下移动 864 像素
  2. 透明度参数0.0表示完全透明,1.0表示完全不透明
  3. 不同 track_name 的贴纸会按轨道顺序叠加显示,可通过 relative_index 调整不同轨道的层级,越大越靠前。
© 版权声明
THE END
喜欢就支持一下吧
点赞14 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容