剪映剪辑助手-滤镜与特效

显示全部

滤镜与特效

剪映剪辑助手 / 滤镜与特效类动作。

添加滤镜片段

add_jianying_filter_clip

剪映剪辑助手滤镜与特效

用途：按客户端可见滤镜名称或资源ID，向独立滤镜轨添加滤镜片段。

写法：添加滤镜片段滤镜名称=<滤镜名称> [开始时间=<开始时间>] [持续时长=<持续时长>] [轨道=<轨道>] [滤镜强度=<滤镜强度>] [原片段后移=<原片段后移>]

保存为

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

正确示例

添加滤镜片段 滤镜名称="示例名称" 开始时间=1

错误示例

添加滤镜片段 开始时间=1

为什么错：漏写了必填参数：滤镜名称。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
滤镜名称	`filter_name`	客户端可见滤镜名称，也兼容资源ID/效果ID；名称不确定时先调用 list_jianying_filter_catalog 查询。	是	无
开始时间	`start_time`	滤镜片段开始时间。	否	无
持续时长	`duration`	滤镜片段持续时长。	否	3s
轨道	`track_name`	目标滤镜轨道；不填时默认使用滤镜轨。	否	无
滤镜强度	`intensity`	滤镜强度，0 到 100，默认 100。	否	100.0
原片段后移	`move_original_segments`	是否先给新滤镜片段腾位置；是=命中的原滤镜片段整体后移，如开始时间落在片段内部则先切分再后移；否=按覆盖语义处理原滤镜片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`轨道ID`	string	否	未提供说明
`片段ID`	string	否	未提供说明
`素材ID`	string	否	未提供说明
`滤镜名称`	string	否	未提供说明
`资源ID`	string	否	未提供说明
`效果ID`	string	否	未提供说明
`滤镜强度`	number	否	未提供说明
`原片段后移`	boolean	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明
`添加方式`	string	否	未提供说明

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

添加特效片段

add_jianying_video_effect_clip

剪映剪辑助手滤镜与特效

用途：按客户端可见特效名称或资源ID，向独立特效轨添加特效片段。

写法：添加特效片段特效名称=<特效名称> [开始时间=<开始时间>] [持续时长=<持续时长>] [轨道=<轨道>] [原片段后移=<原片段后移>]

保存为

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

正确示例

添加特效片段 特效名称="示例名称" 开始时间=1

错误示例

添加特效片段 开始时间=1

为什么错：漏写了必填参数：特效名称。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
特效名称	`effect_name`	客户端可见视频特效名称，也兼容资源ID/效果ID；名称不确定时先调用 list_jianying_video_effect_catalog 查询。	是	无
开始时间	`start_time`	特效片段开始时间。	否	无
持续时长	`duration`	特效片段持续时长。	否	3s
轨道	`track_name`	目标特效轨道；不填时默认使用特效轨。	否	无
原片段后移	`move_original_segments`	是否先给新特效片段腾位置；是=命中的原特效片段整体后移，如开始时间落在片段内部则先切分再后移；否=按覆盖语义处理原特效片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`轨道ID`	string	否	未提供说明
`片段ID`	string	否	未提供说明
`素材ID`	string	否	未提供说明
`特效名称`	string	否	未提供说明
`资源ID`	string	否	未提供说明
`效果ID`	string	否	未提供说明
`参数数量`	integer	否	未提供说明
`原片段后移`	boolean	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明
`添加方式`	string	否	未提供说明

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

添加视频滤镜

add_jianying_video_filter

剪映剪辑助手滤镜与特效

用途：直接把滤镜添加到目标视频片段；同类旧滤镜会自动替换。

写法：添加视频滤镜轨道=<轨道> 滤镜名称=<滤镜名称> [片段序号=<片段序号>] [滤镜强度=<滤镜强度>]

保存为

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

正确示例

添加视频滤镜 轨道="示例名称" 滤镜名称="示例名称"

错误示例

添加视频滤镜 轨道="示例名称"

为什么错：漏写了必填参数：滤镜名称。

展开查看参数和注意事项

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

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`滤镜名称`	string	否	未提供说明
`资源ID`	string	否	未提供说明
`效果ID`	string	否	未提供说明
`是否VIP`	boolean	否	未提供说明
`清理旧数量`	integer	否	未提供说明
`滤镜强度`	number	否	未提供说明
`添加方式`	string	否	未提供说明

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

添加视频特效

add_jianying_video_effect

剪映剪辑助手滤镜与特效

用途：直接把视频特效添加到目标视频片段；同类旧特效会自动替换。

写法：添加视频特效轨道=<轨道> 特效名称=<特效名称> [片段序号=<片段序号>]

保存为

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

正确示例

添加视频特效 轨道="示例名称" 特效名称="示例名称"

错误示例

添加视频特效 轨道="示例名称"

为什么错：漏写了必填参数：特效名称。

展开查看参数和注意事项

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

返回结果

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

返回结果

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

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

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