剪映剪辑助手-视频

显示全部

视频

剪映剪辑助手 / 视频类动作。

添加视频片段

add_jianying_video

剪映剪辑助手视频

用途：向当前草稿的视频轨添加视频素材片段；支持覆盖模式和原片段后移模式。

写法：添加视频片段素材路径=<素材路径> [开始时间=<开始时间>] [持续时长=<持续时长>] [轨道=<轨道>] [素材开始时间=<素材开始时间>] [套用模板属性=<套用模板属性>] [原片段后移=<原片段后移>]

保存为

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

正确示例

添加视频片段 素材路径="D:/demo.txt" 开始时间=1

错误示例

添加视频片段 开始时间=1

为什么错：漏写了必填参数：素材路径。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
素材路径	`media_path`	要加入草稿的本地视频或图片路径。	是	无
开始时间	`start_time`	放到时间线上的开始时间。	否	无
持续时长	`duration`	片段持续时长。	否	无
轨道	`track_name`	目标视频轨道；不填时自动使用默认轨道名。	否	无
素材开始时间	`source_start`	从视频素材内部什么时间开始截取。	否	0
套用模板属性	`template_property`	已保存视频属性名；填写后会在新建片段时直接套用模板属性。	否	无
原片段后移	`move_original_segments`	是否先给新片段腾位置；是=命中的原片段整体后移，如开始时间落在片段内部则先切分再后移；否=按覆盖语义处理原片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`素材类型`	string	否	未提供说明
`素材路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`素材ID`	string	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明
`原片段后移`	boolean	否	未提供说明

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

设置视频片段属性

set_jianying_segment_transform

剪映剪辑助手视频

用途：设置指定视频或图片片段的位置、缩放、旋转、镜像、倒放、混合方式和不透明度。

写法：设置视频片段属性 [轨道=<轨道>] [片段序号=<片段序号>] [缩放=<缩放>] [位置=<位置>] [旋转=<旋转>] [镜像=<镜像>] [倒放=<倒放>] [混合方式=<混合方式>] [不透明度=<不透明度>] [批量失败继续=<批量失败继续>]

保存为

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

正确示例

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

错误示例

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

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标视频轨道或图片轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
缩放	`scale`	缩放；支持单个值或 x,y 两个值，例如 1.2 或 "1.2,0.8"。单值会同时用于宽高，也支持在数值位里写随机(...)。	否	无
位置	`position`	位置，单位为画布像素；原点在画布中心，X 正值向右、Y 正值向上；格式为 "x,y"，例如 "120,-60"。落盘时会按当前画布宽高归一化。	否	无
旋转	`rotation`	旋转角度，单位为度。	否	无
镜像	`mirror`	镜像；支持水平/垂直/全部/无，也可传 true 表示水平镜像。	否	无
倒放	`reverse`	是否倒放视频片段；目标为图片片段时会忽略。	否	无
混合方式	`blend_mode`	混合方式；支持正片叠底/颜色减淡/颜色加深/线性加深/柔光/强光/滤色/叠加/变亮/变暗；填无可清空混合方式。	否	无
不透明度	`alpha`	不透明度，0 到 1；客户端通常显示为百分比。	否	无
批量失败继续	`continue_on_item_error`	批量命中时遇到失败片段是否跳过并继续处理其它命中片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`目标片段数量`	integer	否	未提供说明
`目标片段列表`	array	否	未提供说明
`失败片段数量`	integer	否	未提供说明
`失败片段列表`	array	否	未提供说明
`缩放宽度`	number	否	未提供说明
`缩放高度`	number	否	未提供说明
`位置X`	number	否	未提供说明
`位置Y`	number	否	未提供说明
`旋转`	number	否	未提供说明
`镜像`	string \| null	否	未提供说明
`倒放`	boolean	否	未提供说明
`混合方式`	string \| null	否	未提供说明
`不透明度`	number	否	未提供说明
`存储横向位置`	number	否	未提供说明
`存储纵向位置`	number	否	未提供说明

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

从视频片段套用视频属性

apply_jianying_video_segment_attributes

剪映剪辑助手视频

用途：把来源视频片段的指定属性组复制到目标视频或图片片段。

写法：从视频片段套用视频属性来源轨道=<来源轨道> [来源片段序号=<来源片段序号>] 目标轨道=<目标轨道> [目标片段序号=<目标片段序号>] [属性组=<属性组>] [清理旧属性=<清理旧属性>] [批量失败继续=<批量失败继续>]

保存为

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

正确示例

从视频片段套用视频属性 来源轨道="示例名称" 目标轨道="示例名称"

错误示例

从视频片段套用视频属性 来源轨道="示例名称"

为什么错：漏写了必填参数：目标轨道。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
来源轨道	`source_track_name`	来源视频轨道。	是	无
来源片段序号	`source_segment_index`	来源轨道内片段序号，从 1 开始；默认取该轨道第 1 个片段。支持 random/随机或 A\|B\|C 从候选里随机单选。	否	无
目标轨道	`target_track_name`	目标轨道。	是	无
目标片段序号	`target_segment_index`	目标轨道内片段选择表达式，从 1 开始。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
属性组	`attribute_groups`	要套用的属性组；支持基础属性/混合/蒙版/音频/关键帧/滤镜/转场/视频特效/视觉/全部，默认基础属性,混合,蒙版,音频。	否	无
清理旧属性	`clear_existing`	套用前是否先清理目标片段里同组旧属性。	否	True
批量失败继续	`continue_on_item_error`	批量命中时遇到失败片段是否跳过并继续处理其它命中片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`来源轨道名`	string	否	未提供说明
`来源片段序号`	integer	否	未提供说明
`来源片段ID`	string	否	未提供说明
`属性组列表`	array	否	未提供说明
`目标片段数量`	integer	否	未提供说明
`目标片段列表`	array	否	未提供说明
`复制素材数量`	integer	否	未提供说明
`复制关键帧数量`	integer	否	未提供说明
`失败片段数量`	integer	否	未提供说明
`失败片段列表`	array	否	未提供说明

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

从模板草稿提取视频属性

extract_jianying_video_properties

剪映剪辑助手视频

用途：从模板草稿的指定视频片段提取一份视频属性，并保存为运行时视频属性名。

写法：从模板草稿提取视频属性来源草稿名=<来源草稿名> [来源轨道序号=<来源轨道序号>] [来源片段序号=<来源片段序号>] [属性组=<属性组>] 保存为=<保存为> [覆盖已有=<覆盖已有>]

保存为

默认保存主结果，通常就是 视频属性名 这个字段。

正确示例

从模板草稿提取视频属性 来源草稿名="示例名称" 保存为="示例值"

错误示例

从模板草稿提取视频属性 来源草稿名="示例名称"

为什么错：漏写了必填参数：保存为。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
来源草稿名	`source_draft_name`	模板草稿名称。	是	无
来源轨道序号	`source_track_index`	模板草稿里同类视频轨道的第几条，从 1 开始。	否	1
来源片段序号	`source_segment_index`	模板片段序号，从 1 开始。	否	1
属性组	`property_groups`	属性组；不填时默认全部。支持全部/滤镜/特效/转场/视频效果，也支持逗号分隔。	否	无
保存为	`save_as`	把提取结果保存成这个视频属性名。	是	无
覆盖已有	`overwrite`	视频属性名已存在时是否覆盖。默认不覆盖。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`视频属性名`	string	否	未提供说明
`属性组列表`	array	否	未提供说明
`来源草稿名`	string	否	未提供说明
`来源轨道`	string	否	未提供说明
`来源片段序号`	integer	否	未提供说明
`覆盖已有`	boolean	否	未提供说明

返回/保存方式：动作本身包含 save_as 参数；如果要保留动作完整返回对象，请改用返回结果=变量名。

套用已保存视频属性

apply_saved_jianying_properties

剪映剪辑助手视频

用途：把已保存的视频属性套用到目标轨道或目标轨道片段。

写法：套用已保存视频属性视频属性名=<视频属性名> 目标轨道=<目标轨道> [目标片段序号=<目标片段序号>] [属性组=<属性组>] [清理旧属性=<清理旧属性>] [批量失败继续=<批量失败继续>]

保存为

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

正确示例

套用已保存视频属性 视频属性名="D:/demo.mp4" 目标轨道="示例名称"

错误示例

套用已保存视频属性 视频属性名="D:/demo.mp4"

为什么错：漏写了必填参数：目标轨道。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
视频属性名	`property_name`	已提取好的视频属性名。	是	无
目标轨道	`target_track_name`	目标轨道。	是	无
目标片段序号	`target_segment_index`	目标轨道片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。当只套用转场时，命中结果还必须是可接后续片段的位置。	否	无
属性组	`property_groups`	属性组；不填时默认全部。支持全部/滤镜/特效/转场/视频效果，也支持逗号分隔。	否	无
清理旧属性	`clear_existing`	套用前是否先清理同组旧属性。	否	True
批量失败继续	`continue_on_item_error`	批量命中时遇到失败片段是否跳过并继续处理其它命中片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`来源`	string	否	未提供说明
`属性组列表`	array	否	未提供说明
`目标片段数量`	integer	否	未提供说明
`复制素材数量`	integer	否	未提供说明
`复制关键帧数量`	integer	否	未提供说明
`失败片段数量`	integer	否	未提供说明
`失败片段列表`	array	否	未提供说明

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

智能镜头分割

smart_split_jianying_segment_by_scene

剪映剪辑助手视频

用途：检测指定剪映视频片段内的镜头边界，并按镜头边界将该片段切成多个片段。

写法：智能镜头分割 [轨道=<轨道>] [片段序号=<片段序号>] [分割阈值=<分割阈值>]

保存为

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

正确示例

智能镜头分割 轨道="示例值" 片段序号="示例值"

错误示例

智能镜头分割 轨道="示例值" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track`	目标视频轨道；支持轨道 ID、真实轨道名、视频:1 这类轨道选择器和当前轨道；不填时使用当前轨道。	否	无
片段序号	`segment_index`	目标片段序号。支持单个正序序号（从 1 开始）和倒数序号；不填时默认取该轨道第 1 个片段。	否	无
分割阈值	`threshold`	PySceneDetect 的内容变化阈值，越小越敏感；默认 30。	否	30.0

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`素材路径`	string	否	未提供说明
`原片段ID`	string	否	未提供说明
`原片段序号`	integer	否	未提供说明
`分割阈值`	number	否	未提供说明
`镜头数量`	integer	否	未提供说明
`切分次数`	integer	否	未提供说明
`片段列表`	array	否	未提供说明
`切分结果`	array	否	未提供说明

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

设置蒙版

set_jianying_segment_mask

剪映剪辑助手视频

用途：给指定视频或图片片段设置蒙版。

写法：设置蒙版 [轨道=<轨道>] [片段序号=<片段序号>] [蒙版类型=<蒙版类型>] [位置=<位置>] [蒙版宽度=<蒙版宽度>] [蒙版高度=<蒙版高度>] [羽化=<羽化>] [旋转角度=<旋转角度>] [反转=<反转>] [圆角=<圆角>] [先清理旧蒙版=<先清理旧蒙版>]

保存为

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

正确示例

设置蒙版 轨道="示例名称" 片段序号="示例值"

错误示例

设置蒙版 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个正序序号（从 1 开始）和倒数序号；不填时默认取该轨道第 1 个片段。	否	无
蒙版类型	`mask_name`	蒙版类型；支持线性/镜面/圆形/矩形/爱心/星形，也兼容 circle/rectangle/heart/star 等英文名。	否	线性
位置	`position`	蒙版中心位置，单位为像素；只支持 x,y，例如 120,-60，以素材中心为原点，正值向右/向下。	否	0,0
蒙版宽度	`width`	蒙版宽度，单位为像素；当前对矩形蒙版完全生效。	否	512.0
蒙版高度	`height`	蒙版高度，单位为像素。	否	512.0
羽化	`feather`	羽化程度，0 到 100。	否	0.0
旋转角度	`rotation`	旋转角度，单位为度。	否	0.0
反转	`invert`	是否反转蒙版。	否	False
圆角	`round_corner`	圆角大小，0 到 100；仅矩形蒙版生效。	否	0.0
先清理旧蒙版	`clear_existing`	是否先清理目标片段上的旧蒙版。	否	True

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`清理旧蒙版`	boolean	否	未提供说明
`蒙版类型`	string	否	未提供说明
`蒙版ID`	string	否	未提供说明

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

添加视频转场

add_jianying_video_transition

剪映剪辑助手视频

用途：直接把转场添加到目标视频片段；旧转场会先清空再挂新转场。

写法：添加视频转场轨道=<轨道> 转场名称=<转场名称> [片段序号=<片段序号>] [转场时长=<转场时长>]

保存为

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

正确示例

添加视频转场 轨道="示例名称" 转场名称="示例名称"

错误示例

添加视频转场 轨道="示例名称"

为什么错：漏写了必填参数：转场名称。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标视频轨道。	是	无
转场名称	`transition_name`	客户端可见转场名称，也兼容资源ID/效果ID。	是	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
转场时长	`duration`	转场时长；不填时使用该转场默认时长。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`转场名称`	string	否	未提供说明
`资源ID`	string	否	未提供说明
`效果ID`	string	否	未提供说明
`是否VIP`	boolean	否	未提供说明
`清理旧效果`	boolean	否	未提供说明
`清理旧数量`	integer	否	未提供说明
`转场时长`	integer	否	未提供说明
`允许重叠`	boolean	否	未提供说明
`添加方式`	string	否	未提供说明

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