剪映剪辑助手-片段

显示全部

片段

剪映剪辑助手 / 片段类动作。

删除片段

delete_jianying_segment

剪映剪辑助手片段

用途：删除当前剪映草稿中的指定轨道片段。

写法：删除片段 [轨道=<轨道>] [片段序号=<片段序号>] [后续片段前移=<后续片段前移>]

保存为

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

正确示例

删除片段 轨道="示例名称" 片段序号="示例值"

错误示例

删除片段 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
后续片段前移	`shift_following_segments`	是否让同轨后续片段按被删片段时长整体前移。默认 False。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`删除片段序号`	integer	否	未提供说明
`删除片段ID`	string	否	未提供说明
`素材ID`	string	否	未提供说明
`删除片段数量`	integer	否	未提供说明
`删除片段列表`	array	否	未提供说明
`后续片段前移`	boolean	否	未提供说明
`前移片段数量`	integer	否	未提供说明
`总时长`	integer	否	未提供说明

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

复制片段

duplicate_jianying_segment

剪映剪辑助手片段

用途：通过原语组合，复制指定轨道片段到目标轨道。

写法：复制片段 [轨道=<轨道>] [片段序号=<片段序号>] 目标轨道=<目标轨道> [开始时间=<开始时间>] [是否复制效果=<是否复制效果>]

保存为

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

正确示例

复制片段 目标轨道="示例名称" 轨道="示例名称"

错误示例

复制片段 轨道="示例名称"

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	源轨道。	否	无
片段序号	`segment_index`	源轨道内片段选择表达式。支持单个序号、倒数、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。不支持 all/全部、逗号并集或范围批量。	否	无
目标轨道	`target_track_name`	复制到的目标轨道。	是	无
开始时间	`start_time`	新片段开始时间；不填时追加到目标轨尾。	否	无
是否复制效果	`copy_effects`	是否复制附加效果引用。	否	True

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`源轨道名`	string	否	未提供说明
`源片段序号`	integer	否	未提供说明
`源片段ID`	string	否	未提供说明
`目标轨道名`	string	否	未提供说明
`目标片段序号`	integer	否	未提供说明
`新片段ID`	string	否	未提供说明
`新素材ID`	string	否	未提供说明
`复制效果数量`	integer	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明

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

移动片段

move_jianying_segment

剪映剪辑助手片段

用途：移动当前剪映草稿中的指定片段到新的时间位置，支持视频/图片/音频/文字/贴纸/滤镜/特效片段，可选覆盖目标区间或插入腾位。

写法：移动片段 [轨道=<轨道>] [片段序号=<片段序号>] [目标轨道=<目标轨道>] 开始时间=<开始时间> [时间类型=<时间类型>] [是否覆盖=<是否覆盖>]

保存为

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

正确示例

移动片段 开始时间=1 轨道="示例名称"

错误示例

移动片段 轨道="示例名称"

为什么错：漏写了必填参数：开始时间。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	源轨道。支持视频/图片/音频/文字/贴纸/滤镜/特效片段。	否	无
片段序号	`segment_index`	源轨道内片段选择表达式。支持单个序号、倒数、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。不支持 all/全部、逗号并集或范围批量。	否	无
目标轨道	`target_track_name`	目标轨道；不填时默认仍在原轨道内移动。跨轨时只支持同类型轨道之间移动。	否	无
开始时间	`start_time`	目标开始时间；当时间类型=absolute 时表示草稿时间线上的绝对时间，当时间类型=relative 时表示相对当前片段开始时间的偏移。	是	无
时间类型	`time_type`	时间类型。支持 absolute/relative，默认 absolute。	否	absolute
是否覆盖	`overwrite`	是否覆盖目标时间区间已有内容。True=覆盖模式，False=插入腾位模式。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`目标轨道名`	string	否	未提供说明
`目标片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明
`时间类型`	string	否	未提供说明
`是否覆盖`	boolean	否	未提供说明

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

选择片段

select_jianying_segments

剪映剪辑助手片段

用途：按轨道和片段表达式选出片段，返回命中列表，并在只命中单轨时写入当前轨道。

写法：选择片段 [轨道=<轨道>] [片段序号=<片段序号>]

保存为

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

正确示例

选择片段 轨道="示例名称" 片段序号="示例值"

错误示例

选择片段 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`命中轨道数量`	integer	否	未提供说明
`命中片段数量`	integer	否	未提供说明
`片段列表`	array	否	未提供说明

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

分割片段

split_jianying_segment

剪映剪辑助手片段

用途：将当前剪映草稿中同轨指定片段按相对时间或绝对时间切成左右两段。

写法：分割片段 [轨道=<轨道>] [片段序号=<片段序号>] 切分时间=<切分时间> [时间类型=<时间类型>] [继承侧=<继承侧>]

保存为

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

正确示例

分割片段 切分时间=1 轨道="示例名称"

错误示例

分割片段 轨道="示例名称"

为什么错：漏写了必填参数：切分时间。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、倒数、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。不支持 all/全部、逗号并集或范围批量。	否	无
切分时间	`split_time`	切分时间；当时间类型=relative 时表示相对片段开始时间的偏移，当时间类型=absolute 时表示草稿时间线上的绝对时间。必须落在片段内部。当前支持视频/图片/音频/文字/贴纸/滤镜/特效片段。	是	0
时间类型	`time_type`	切分时间类型。支持 relative/absolute，默认 relative。	否	relative
继承侧	`inherit_side`	哪一侧继承原片段 ID。支持 left/right，默认 left。	否	left

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段类型`	string	否	未提供说明
`左片段序号`	integer	否	未提供说明
`左片段ID`	string	否	未提供说明
`右片段序号`	integer	否	未提供说明
`右片段ID`	string	否	未提供说明
`左开始时间`	integer	否	未提供说明
`左持续时长`	integer	否	未提供说明
`右开始时间`	integer	否	未提供说明
`右持续时长`	integer	否	未提供说明
`切分偏移`	integer	否	未提供说明
`时间类型`	string	否	未提供说明
`继承侧`	string	否	未提供说明

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

设置片段时长

set_jianying_segment_duration

剪映剪辑助手片段

用途：设置当前剪映草稿中指定轨道片段的持续时长。

写法：设置片段时长 [轨道=<轨道>] [片段序号=<片段序号>] 持续时长=<持续时长>

保存为

默认保存主结果，通常就是 新持续时长 这个字段。

正确示例

设置片段时长 持续时长=1 轨道="示例名称"

错误示例

设置片段时长 轨道="示例名称"

为什么错：漏写了必填参数：持续时长。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、倒数、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。不支持 all/全部、逗号并集或范围批量。	否	无
持续时长	`duration`	新的持续时长。	是	无

返回结果

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

返回结果

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

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

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

设置片段动画

set_jianying_segment_track_animation

剪映剪辑助手片段

用途：设置指定视觉片段的轨道动画，支持视频、图片、文字、贴纸片段。

写法：设置片段动画 [轨道=<轨道>] [片段序号=<片段序号>] [入场动画=<入场动画>] [入场时长=<入场时长>] [出场动画=<出场动画>] [出场时长=<出场时长>] [循环动画=<循环动画>]

保存为

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

正确示例

设置片段动画 轨道="示例名称" 片段序号="示例值"

错误示例

设置片段动画 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标视觉轨道。支持视频、图片、文字、贴纸轨。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个正序序号（从 1 开始）和倒数序号；不填时默认取该轨道第 1 个片段。	否	无
入场动画	`intro_animation`	入场动画名称，也支持直接传资源ID或效果ID；不填则清空入场动画。	否	无
入场时长	`intro_duration`	入场动画时长；不填时默认使用该动画预设时长。	否	无
出场动画	`outro_animation`	出场动画名称，也支持直接传资源ID或效果ID；不填则清空出场动画。	否	无
出场时长	`outro_duration`	出场动画时长；不填时默认使用该动画预设时长。	否	无
循环动画	`loop_animation`	循环动画名称；对视频/图片/贴纸实际对应组合动画，不填则清空该槽位。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`动画素材ID`	string	否	未提供说明
`动画类型`	string	否	未提供说明
`入场动画`	string \| null	否	未提供说明
`入场时长`	integer \| null	否	未提供说明
`出场动画`	string \| null	否	未提供说明
`出场时长`	integer \| null	否	未提供说明
`循环动画`	string \| null	否	未提供说明
`清理旧动画数量`	integer	否	未提供说明
`清理旧动画素材ID列表`	array	否	未提供说明

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

随机保留片段

keep_random_jianying_segments

剪映剪辑助手片段

用途：从指定轨道片段候选里随机保留指定数量，并删除其余片段。适合把一条贴纸轨上的多个候选贴纸随机留下 N 个。

写法：随机保留片段 [轨道=<轨道>] 保留数量=<保留数量> [片段序号=<片段序号>]

保存为

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

正确示例

随机保留片段 保留数量=1 轨道="示例名称"

错误示例

随机保留片段 轨道="示例名称"

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道。	否	无
保留数量	`keep_count`	要随机保留的片段数量。支持 0，表示删除候选里的全部片段。	是	无
片段序号	`segment_index`	候选片段选择表达式。留空时默认把该轨全部片段都作为候选。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`候选片段数量`	integer	否	未提供说明
`保留片段数量`	integer	否	未提供说明
`删除片段数量`	integer	否	未提供说明
`候选片段列表`	array	否	未提供说明
`保留片段列表`	array	否	未提供说明
`删除片段列表`	array	否	未提供说明
`总时长`	integer	否	未提供说明

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