剪映剪辑助手-贴纸与图形

显示全部

贴纸与图形

剪映剪辑助手 / 贴纸与图形 类动作。

添加贴纸片段

add_jianying_sticker_clip

剪映剪辑助手贴纸与图形

用途：使用贴纸资源ID直接添加贴纸片段。

写法：添加贴纸片段 贴纸资源ID=<贴纸资源ID> [开始时间=<开始时间>] [持续时长=<持续时长>] [轨道=<轨道>] [整体缩放=<整体缩放>] [位置=<位置>] [旋转角度=<旋转角度>] [不透明度=<不透明度>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加贴纸片段 贴纸资源ID="示例值" 开始时间=1

错误示例

添加贴纸片段 开始时间=1

为什么错：漏写了必填参数：贴纸资源ID。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
贴纸资源IDsticker_resource_id官方贴纸 resource_id；示例：7263005587686837523。可先调用 list_jianying_sticker_resources 查询。是无
开始时间start_time贴纸放到时间线上的开始时间；不填时接到贴纸轨道末尾。否无
持续时长duration贴纸片段持续时长，默认 3s。否3s
轨道track_name目标贴纸轨道，默认 StickerTrack。否无
整体缩放scale贴纸整体缩放比例，默认 1.0。否1.0
位置position位置，单位为像素；只支持 x,y，例如 120,-60，以画布中心为原点，正值向右/向下。否0,0
旋转角度rotation顺时针旋转角度。否0.0
不透明度alpha不透明度，0 到 1。否1.0
原片段后移move_original_segments是否先给新贴纸片段腾位置；是=命中的原贴纸片段整体后移，如开始时间落在片段内部则先切分再后移；否=按覆盖语义处理原贴纸片段。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
贴纸素材IDstring否未提供说明
贴纸资源IDstring否未提供说明
贴纸名string否未提供说明
解析方式string否未提供说明
来源草稿路径string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明
原片段后移boolean否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

添加直线片段

add_jianying_line_shape_clip

剪映剪辑助手贴纸与图形

用途：向剪映草稿添加一个图形库直线片段。

写法：添加直线片段 [轨道=<轨道>] [开始时间=<开始时间>] [持续时长=<持续时长>] [宽度=<宽度>] [高度=<高度>] [位置=<位置>] [缩放X=<缩放X>] [缩放Y=<缩放Y>] [旋转=<旋转>] [开启属性=<开启属性>] [描边颜色=<描边颜色>] [描边粗细=<描边粗细>] [描边不透明度=<描边不透明度>] [描边样式=<描边样式>] [阴影颜色=<阴影颜色>] [阴影距离=<阴影距离>] [阴影角度=<阴影角度>] [阴影不透明度=<阴影不透明度>] [左端点=<左端点>] [右端点=<右端点>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加直线片段 轨道="示例名称" 开始时间=1

错误示例

添加直线片段 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
开始时间start_time片段开始时间。不填时追加到轨道末尾。否无
持续时长duration片段持续时长，默认 3s。否3s
宽度width图形面板宽度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
高度height图形面板高度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否1
位置position位置，格式 "x,y"，按当前草稿分辨率写入归一化 transform。否0,0
缩放Xscale_x横向缩放，1 表示 100%。否1.0
缩放Yscale_y纵向缩放，1 表示 100%。否1.0
旋转rotation旋转角度。否0.0
开启属性enabled_properties开启属性，逗号分隔。闭合图形支持 描边/填充/圆角/阴影；直线支持 描边/阴影。不写时直线默认描边，闭合图形默认填充；写空字符串表示全关。否无
描边颜色border_color描边颜色，#RRGGBB。否#ffffff
描边粗细border_width描边粗细。否4
描边不透明度border_alpha描边不透明度，0-1。否1.0
描边样式border_line_style描边样式：直线/虚线/点线。否直线
阴影颜色shadow_color阴影颜色，#RRGGBB。否#000000
阴影距离shadow_distance阴影距离。否10
阴影角度shadow_angle阴影角度。否45
阴影不透明度shadow_alpha阴影不透明度，0-1。否0.5
左端点left_endpoint左端点样式：无端点/箭头/圆形。否无端点
右端点right_endpoint右端点样式：无端点/箭头/圆形。否无端点
原片段后移move_original_segments是否插入并整体后移原片段，默认 False。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
素材IDstring否未提供说明
图形名称string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

添加矩形片段

add_jianying_rect_shape_clip

剪映剪辑助手贴纸与图形

用途：向剪映草稿添加一个图形库矩形片段。

写法：添加矩形片段 [轨道=<轨道>] [开始时间=<开始时间>] [持续时长=<持续时长>] [宽度=<宽度>] [高度=<高度>] [位置=<位置>] [缩放X=<缩放X>] [缩放Y=<缩放Y>] [旋转=<旋转>] [开启属性=<开启属性>] [描边颜色=<描边颜色>] [描边粗细=<描边粗细>] [描边不透明度=<描边不透明度>] [描边样式=<描边样式>] [填充颜色=<填充颜色>] [填充不透明度=<填充不透明度>] [圆角=<圆角>] [阴影颜色=<阴影颜色>] [阴影距离=<阴影距离>] [阴影角度=<阴影角度>] [阴影不透明度=<阴影不透明度>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加矩形片段 轨道="示例名称" 开始时间=1

错误示例

添加矩形片段 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
开始时间start_time片段开始时间。不填时追加到轨道末尾。否无
持续时长duration片段持续时长，默认 3s。否3s
宽度width图形面板宽度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
高度height图形面板高度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
位置position位置，格式 "x,y"，按当前草稿分辨率写入归一化 transform。否0,0
缩放Xscale_x横向缩放，1 表示 100%。否1.0
缩放Yscale_y纵向缩放，1 表示 100%。否1.0
旋转rotation旋转角度。否0.0
开启属性enabled_properties开启属性，逗号分隔。闭合图形支持 描边/填充/圆角/阴影；直线支持 描边/阴影。不写时直线默认描边，闭合图形默认填充；写空字符串表示全关。否无
描边颜色border_color描边颜色，#RRGGBB。否#ffffff
描边粗细border_width描边粗细。否4
描边不透明度border_alpha描边不透明度，0-1。否1.0
描边样式border_line_style描边样式：直线/虚线/点线。否直线
填充颜色fill_color填充颜色，#RRGGBB。否#ffffff
填充不透明度fill_alpha填充不透明度，0-1。否1.0
圆角roundness圆角。可写单值，或 左上,右上,右下,左下。否无
阴影颜色shadow_color阴影颜色，#RRGGBB。否#000000
阴影距离shadow_distance阴影距离。否10
阴影角度shadow_angle阴影角度。否45
阴影不透明度shadow_alpha阴影不透明度，0-1。否0.5
原片段后移move_original_segments是否插入并整体后移原片段，默认 False。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
素材IDstring否未提供说明
图形名称string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

添加圆形片段

add_jianying_circle_shape_clip

剪映剪辑助手贴纸与图形

用途：向剪映草稿添加一个图形库圆形片段。

写法：添加圆形片段 [轨道=<轨道>] [开始时间=<开始时间>] [持续时长=<持续时长>] [宽度=<宽度>] [高度=<高度>] [位置=<位置>] [缩放X=<缩放X>] [缩放Y=<缩放Y>] [旋转=<旋转>] [开启属性=<开启属性>] [描边颜色=<描边颜色>] [描边粗细=<描边粗细>] [描边不透明度=<描边不透明度>] [描边样式=<描边样式>] [填充颜色=<填充颜色>] [填充不透明度=<填充不透明度>] [圆角=<圆角>] [阴影颜色=<阴影颜色>] [阴影距离=<阴影距离>] [阴影角度=<阴影角度>] [阴影不透明度=<阴影不透明度>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加圆形片段 轨道="示例名称" 开始时间=1

错误示例

添加圆形片段 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
开始时间start_time片段开始时间。不填时追加到轨道末尾。否无
持续时长duration片段持续时长，默认 3s。否3s
宽度width图形面板宽度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
高度height图形面板高度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
位置position位置，格式 "x,y"，按当前草稿分辨率写入归一化 transform。否0,0
缩放Xscale_x横向缩放，1 表示 100%。否1.0
缩放Yscale_y纵向缩放，1 表示 100%。否1.0
旋转rotation旋转角度。否0.0
开启属性enabled_properties开启属性，逗号分隔。闭合图形支持 描边/填充/圆角/阴影；直线支持 描边/阴影。不写时直线默认描边，闭合图形默认填充；写空字符串表示全关。否无
描边颜色border_color描边颜色，#RRGGBB。否#ffffff
描边粗细border_width描边粗细。否4
描边不透明度border_alpha描边不透明度，0-1。否1.0
描边样式border_line_style描边样式：直线/虚线/点线。否直线
填充颜色fill_color填充颜色，#RRGGBB。否#ffffff
填充不透明度fill_alpha填充不透明度，0-1。否1.0
圆角roundness圆角。可写单值，或 左上,右上,右下,左下。否无
阴影颜色shadow_color阴影颜色，#RRGGBB。否#000000
阴影距离shadow_distance阴影距离。否10
阴影角度shadow_angle阴影角度。否45
阴影不透明度shadow_alpha阴影不透明度，0-1。否0.5
原片段后移move_original_segments是否插入并整体后移原片段，默认 False。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
素材IDstring否未提供说明
图形名称string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

添加三角形片段

add_jianying_triangle_shape_clip

剪映剪辑助手贴纸与图形

用途：向剪映草稿添加一个图形库三角形片段。

写法：添加三角形片段 [轨道=<轨道>] [开始时间=<开始时间>] [持续时长=<持续时长>] [宽度=<宽度>] [高度=<高度>] [位置=<位置>] [缩放X=<缩放X>] [缩放Y=<缩放Y>] [旋转=<旋转>] [开启属性=<开启属性>] [描边颜色=<描边颜色>] [描边粗细=<描边粗细>] [描边不透明度=<描边不透明度>] [描边样式=<描边样式>] [填充颜色=<填充颜色>] [填充不透明度=<填充不透明度>] [圆角=<圆角>] [阴影颜色=<阴影颜色>] [阴影距离=<阴影距离>] [阴影角度=<阴影角度>] [阴影不透明度=<阴影不透明度>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加三角形片段 轨道="示例名称" 开始时间=1

错误示例

添加三角形片段 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
开始时间start_time片段开始时间。不填时追加到轨道末尾。否无
持续时长duration片段持续时长，默认 3s。否3s
宽度width图形面板宽度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
高度height图形面板高度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
位置position位置，格式 "x,y"，按当前草稿分辨率写入归一化 transform。否0,0
缩放Xscale_x横向缩放，1 表示 100%。否1.0
缩放Yscale_y纵向缩放，1 表示 100%。否1.0
旋转rotation旋转角度。否0.0
开启属性enabled_properties开启属性，逗号分隔。闭合图形支持 描边/填充/圆角/阴影；直线支持 描边/阴影。不写时直线默认描边，闭合图形默认填充；写空字符串表示全关。否无
描边颜色border_color描边颜色，#RRGGBB。否#ffffff
描边粗细border_width描边粗细。否4
描边不透明度border_alpha描边不透明度，0-1。否1.0
描边样式border_line_style描边样式：直线/虚线/点线。否直线
填充颜色fill_color填充颜色，#RRGGBB。否#ffffff
填充不透明度fill_alpha填充不透明度，0-1。否1.0
圆角roundness圆角。可写单值，或 左上,右上,右下,左下。否无
阴影颜色shadow_color阴影颜色，#RRGGBB。否#000000
阴影距离shadow_distance阴影距离。否10
阴影角度shadow_angle阴影角度。否45
阴影不透明度shadow_alpha阴影不透明度，0-1。否0.5
原片段后移move_original_segments是否插入并整体后移原片段，默认 False。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
素材IDstring否未提供说明
图形名称string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

添加梯形片段

add_jianying_trapezoid_shape_clip

剪映剪辑助手贴纸与图形

用途：向剪映草稿添加一个图形库梯形片段。

写法：添加梯形片段 [轨道=<轨道>] [开始时间=<开始时间>] [持续时长=<持续时长>] [宽度=<宽度>] [高度=<高度>] [位置=<位置>] [缩放X=<缩放X>] [缩放Y=<缩放Y>] [旋转=<旋转>] [开启属性=<开启属性>] [描边颜色=<描边颜色>] [描边粗细=<描边粗细>] [描边不透明度=<描边不透明度>] [描边样式=<描边样式>] [填充颜色=<填充颜色>] [填充不透明度=<填充不透明度>] [圆角=<圆角>] [阴影颜色=<阴影颜色>] [阴影距离=<阴影距离>] [阴影角度=<阴影角度>] [阴影不透明度=<阴影不透明度>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加梯形片段 轨道="示例名称" 开始时间=1

错误示例

添加梯形片段 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
开始时间start_time片段开始时间。不填时追加到轨道末尾。否无
持续时长duration片段持续时长，默认 3s。否3s
宽度width图形面板宽度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
高度height图形面板高度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
位置position位置，格式 "x,y"，按当前草稿分辨率写入归一化 transform。否0,0
缩放Xscale_x横向缩放，1 表示 100%。否1.0
缩放Yscale_y纵向缩放，1 表示 100%。否1.0
旋转rotation旋转角度。否0.0
开启属性enabled_properties开启属性，逗号分隔。闭合图形支持 描边/填充/圆角/阴影；直线支持 描边/阴影。不写时直线默认描边，闭合图形默认填充；写空字符串表示全关。否无
描边颜色border_color描边颜色，#RRGGBB。否#ffffff
描边粗细border_width描边粗细。否4
描边不透明度border_alpha描边不透明度，0-1。否1.0
描边样式border_line_style描边样式：直线/虚线/点线。否直线
填充颜色fill_color填充颜色，#RRGGBB。否#ffffff
填充不透明度fill_alpha填充不透明度，0-1。否1.0
圆角roundness圆角。可写单值，或 左上,右上,右下,左下。否无
阴影颜色shadow_color阴影颜色，#RRGGBB。否#000000
阴影距离shadow_distance阴影距离。否10
阴影角度shadow_angle阴影角度。否45
阴影不透明度shadow_alpha阴影不透明度，0-1。否0.5
原片段后移move_original_segments是否插入并整体后移原片段，默认 False。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
素材IDstring否未提供说明
图形名称string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

添加平行四边形片段

add_jianying_parallelogram_shape_clip

剪映剪辑助手贴纸与图形

用途：向剪映草稿添加一个图形库平行四边形片段。

写法：添加平行四边形片段 [轨道=<轨道>] [开始时间=<开始时间>] [持续时长=<持续时长>] [宽度=<宽度>] [高度=<高度>] [位置=<位置>] [缩放X=<缩放X>] [缩放Y=<缩放Y>] [旋转=<旋转>] [开启属性=<开启属性>] [描边颜色=<描边颜色>] [描边粗细=<描边粗细>] [描边不透明度=<描边不透明度>] [描边样式=<描边样式>] [填充颜色=<填充颜色>] [填充不透明度=<填充不透明度>] [圆角=<圆角>] [阴影颜色=<阴影颜色>] [阴影距离=<阴影距离>] [阴影角度=<阴影角度>] [阴影不透明度=<阴影不透明度>] [原片段后移=<原片段后移>]

保存为

默认保存主结果，通常就是 片段ID 这个字段。

正确示例

添加平行四边形片段 轨道="示例名称" 开始时间=1

错误示例

添加平行四边形片段 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
开始时间start_time片段开始时间。不填时追加到轨道末尾。否无
持续时长duration片段持续时长，默认 3s。否3s
宽度width图形面板宽度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
高度height图形面板高度，内部按 720 基准宽度换算：shape_size = 面板值 * 720 / canvas_config.width。否320
位置position位置，格式 "x,y"，按当前草稿分辨率写入归一化 transform。否0,0
缩放Xscale_x横向缩放，1 表示 100%。否1.0
缩放Yscale_y纵向缩放，1 表示 100%。否1.0
旋转rotation旋转角度。否0.0
开启属性enabled_properties开启属性，逗号分隔。闭合图形支持 描边/填充/圆角/阴影；直线支持 描边/阴影。不写时直线默认描边，闭合图形默认填充；写空字符串表示全关。否无
描边颜色border_color描边颜色，#RRGGBB。否#ffffff
描边粗细border_width描边粗细。否4
描边不透明度border_alpha描边不透明度，0-1。否1.0
描边样式border_line_style描边样式：直线/虚线/点线。否直线
填充颜色fill_color填充颜色，#RRGGBB。否#ffffff
填充不透明度fill_alpha填充不透明度，0-1。否1.0
圆角roundness圆角。可写单值，或 左上,右上,右下,左下。否无
阴影颜色shadow_color阴影颜色，#RRGGBB。否#000000
阴影距离shadow_distance阴影距离。否10
阴影角度shadow_angle阴影角度。否45
阴影不透明度shadow_alpha阴影不透明度，0-1。否0.5
原片段后移move_original_segments是否插入并整体后移原片段，默认 False。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
素材IDstring否未提供说明
图形名称string否未提供说明
开始时间integer否未提供说明
持续时长integer否未提供说明
结束时间integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 片段ID。

设置贴纸片段属性

set_jianying_sticker_segment_attributes

剪映剪辑助手贴纸与图形

用途：设置一个或多个贴纸片段的位置、缩放和旋转；默认任一片段失败时自动回滚，也可选择批量失败后继续。

写法：设置贴纸片段属性 [轨道=<轨道>] [片段序号=<片段序号>] [缩放=<缩放>] [位置=<位置>] [旋转=<旋转>] [批量失败继续=<批量失败继续>]

保存为

默认保存主结果，通常就是 目标片段列表 这个字段。

正确示例

设置贴纸片段属性 轨道="示例名称" 片段序号="示例值"

错误示例

设置贴纸片段属性 轨道="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
轨道track_name目标贴纸轨道。否无
片段序号segment_index轨道内片段选择表达式；支持单个序号、逗号并集、范围、倒数、all/全部、random/随机和候选随机。否无
缩放scale缩放；支持单个值或 x,y 两个值，例如 1.2 或 "1.2,0.8"。单值会同时用于宽高，也支持在数值位里写 随机(...)。否无
位置position位置，单位为画布像素；原点在画布中心，X 正值向右、Y 正值向上；格式为 "x,y"，例如 "120,-60"。落盘时会按当前画布宽高归一化。否无
旋转rotation旋转角度。否无
批量失败继续continue_on_item_error批量命中时遇到失败片段是否跳过并继续处理其它命中片段；默认关闭，关闭时自动回滚。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
轨道名string否未提供说明
片段序号integer否未提供说明
片段IDstring否未提供说明
位置大小object否未提供说明
缩放宽度number否未提供说明
缩放高度number否未提供说明
位置Xnumber否未提供说明
位置Ynumber否未提供说明
旋转number否未提供说明
目标片段数量integer否未提供说明
目标片段列表array否未提供说明
失败片段数量integer否未提供说明
失败片段列表array否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 目标片段列表。

查询贴纸资源

list_jianying_sticker_resources

剪映剪辑助手贴纸与图形

用途：查询指定草稿里的贴纸资源，可按关键词筛选并返回片段定位、时间和位置大小信息。

写法：查询贴纸资源 [草稿名=<草稿名>] [关键词=<关键词>] [包含片段信息=<包含片段信息>] [返回数量=<返回数量>]

保存为

默认保存主结果，通常就是 贴纸列表 这个字段。

正确示例

查询贴纸资源 草稿名="示例名称" 关键词="示例值"

错误示例

查询贴纸资源 草稿名="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name来源剪映草稿名称；不填时默认读取当前草稿。否无
关键词keyword按贴纸名、贴纸资源ID或素材ID筛选；不填时返回当前草稿全部贴纸资源。否无
包含片段信息include_segments是否同时返回这些贴纸所在的轨道、片段定位、时间和位置大小信息。否True
返回数量limit最多返回多少个贴纸资源；从 1 开始。否无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
关键词string否未提供说明
结果数量integer否未提供说明
片段数量integer否未提供说明
精确匹配数量integer否未提供说明
贴纸列表array否未提供说明
贴纸列表[*]object否数组元素
贴纸列表[*].贴纸序号integer否未提供说明
贴纸列表[*].素材IDstring否未提供说明
贴纸列表[*].贴纸资源IDstring否未提供说明
贴纸列表[*].贴纸名string否未提供说明
贴纸列表[*].贴纸类型string否未提供说明
贴纸列表[*].素材路径string否未提供说明
贴纸列表[*].片段列表array否未提供说明
贴纸列表[*].片段列表[*]object否数组元素
贴纸列表[*].片段列表[*].轨道名string否未提供说明
贴纸列表[*].片段列表[*].片段序号integer否未提供说明
贴纸列表[*].片段列表[*].片段IDstring否未提供说明
贴纸列表[*].片段列表[*].开始时间integer否未提供说明
贴纸列表[*].片段列表[*].持续时长integer否未提供说明
贴纸列表[*].片段列表[*].结束时间integer否未提供说明
贴纸列表[*].片段列表[*].位置大小object否未提供说明
贴纸列表[*].片段列表[*].位置大小.缩放宽度number否未提供说明
贴纸列表[*].片段列表[*].位置大小.缩放高度number否未提供说明
贴纸列表[*].片段列表[*].位置大小.位置Xnumber否未提供说明
贴纸列表[*].片段列表[*].位置大小.位置Ynumber否未提供说明
贴纸列表[*].片段列表[*].位置大小.旋转number否未提供说明
贴纸列表[*].片段列表[*].位置大小.不透明度number否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 贴纸列表。