功能简介

添加贴纸到草稿，为视频添加装饰性的图片元素。贴纸可以增加视频的趣味性和视觉效果。

使用场景

• 需要为视频添加装饰性贴纸
• 需要添加表情包或图标
• 需要为特定时间段显示贴纸

参数说明

输入参数

基础参数：

参数名	类型	必填	说明
贴纸资源ID	字符串	是	贴纸的唯一标识，通过【搜索贴纸】指令来获取
开始显示时间	小数	否	贴纸开始显示的时间，单位：秒，默认0
结束显示时间	小数	否	贴纸结束显示的时间，单位：秒，默认5.0
草稿ID	字符串	否	目标草稿的ID，不填则创建新草稿

位置和变换参数：

参数名	类型	必填	说明
垂直偏移	小数	否	垂直方向的偏移（相对值），单位为半个画布高，范围-1.0到1.0
垂直偏移_像素	整数	否	垂直方向的偏移（像素值），单位：像素
水平偏移	小数	否	水平方向的偏移（相对值），单位为半个画布宽，范围-1.0到1.0
水平偏移_像素	整数	否	水平方向的偏移（像素值），单位：像素
水平缩放	小数	否	水平方向的缩放比例，1.0为原始大小，默认1.0
垂直缩放	小数	否	垂直方向的缩放比例，1.0为原始大小，默认1.0
旋转角度	小数	否	贴纸的旋转角度，单位：度，默认0.0

其他参数：

参数名	类型	必填	说明
贴纸透明度	小数	否	贴纸的透明度，范围0.0-1.0，1.0为完全不透明（默认值），0.0为完全透明
是否水平翻转	布尔值	否	是否水平翻转贴纸，默认false
是否垂直翻转	布尔值	否	是否垂直翻转贴纸，默认false
轨道名称	字符串	否	贴纸所在的轨道名称，默认sticker_main
相对索引	整数	否	轨道相对位置，数值越大越靠上，默认0
画布宽度	整数	否	画布的宽度，单位：像素。仅在创建新草稿时需要指定
画布高度	整数	否	画布的高度，单位：像素。仅在创建新草稿时需要指定

输出参数

参数名	类型	必填	说明
返回草稿ID	字符串	是	操作后的草稿ID
草稿URL	字符串	是	草稿的访问链接

注意事项

贴纸ID获取：贴纸资源ID必须通过【搜索贴纸】指令来获取，不能随意填写

时间范围：开始显示时间必须小于结束显示时间，贴纸会在指定的时间范围内显示

偏移参数：相对值和像素值只需设置其中一个，如果都设置，像素值优先级更高

草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID