剪映剪辑助手-素材替换

显示全部

素材替换

剪映剪辑助手 / 素材替换类动作。

替换全局素材

replace_jianying_material_globally

剪映剪辑助手素材替换

用途：按素材名整体替换当前剪映模板草稿中的视频、图片或音频素材。

写法：替换全局素材新素材路径=<新素材路径> 素材名=<素材名>

保存为

默认保存主结果，通常就是 新素材路径 这个字段。

正确示例

替换全局素材 新素材路径="D:/demo.txt" 素材名="示例名称"

错误示例

替换全局素材 新素材路径="D:/demo.txt"

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
新素材路径	`material_path`	新的本地素材路径。	是	无
素材名	`material_name`	按素材名整体替换时使用。	是	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`命中片段数量`	integer	否	未提供说明
`素材类型`	string	否	未提供说明
`新素材名`	string	否	未提供说明
`新素材路径`	string	否	未提供说明
`新素材时长`	integer	否	未提供说明

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

替换片段素材

replace_jianying_material_by_segment

剪映剪辑助手素材替换

用途：按轨道和片段序号替换当前剪映模板草稿中的目标片段素材。

写法：替换片段素材新素材路径=<新素材路径> 轨道=<轨道> [片段序号=<片段序号>] [新素材内开始时间=<新素材内开始时间>]

保存为

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

正确示例

替换片段素材 新素材路径="D:/demo.txt" 轨道="示例名称"

错误示例

替换片段素材 新素材路径="D:/demo.txt"

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
新素材路径	`material_path`	新的本地素材路径。	是	无
轨道	`track_name`	按轨道定位目标片段。	是	无
片段序号	`segment_index`	轨道内片段序号，从 1 开始；不填时默认取该轨道第 1 个片段。	否	无
新素材内开始时间	`source_start`	新素材内部开始时间；默认从新素材开头使用。	否	0

返回结果

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

返回结果

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

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

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

按时间线添加素材到轨道

apply_audio_timeline_to_jianying

剪映剪辑助手素材替换

用途：按给定时间线片段列表，把音频或视频素材切成多个片段，并连续添加到指定剪映轨道。

写法：按时间线添加素材到轨道 [轨道=<轨道>] 素材路径=<素材路径> 时间线片段列表=<时间线片段列表> [写入开始时间=<写入开始时间>]

保存为

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

正确示例

按时间线添加素材到轨道 素材路径='D:/素材/demo.mp4' 时间线片段列表=[{'start':'0s','end':'1s'}] 写入开始时间=60s

# 说明：把素材的指定片段从目标轨道 60 秒处开始写入。

错误示例

按时间线添加素材到轨道 素材路径="D:/demo.txt"

为什么错：漏写了必填参数：时间线片段列表。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	写入当前草稿的目标轨道名；不填时使用当前轨道。显式传入时不能为空。	否	无
素材路径	`media_path`	要按时间线切分的本地素材路径，通常是原视频或音频。	是	无
时间线片段列表	`keep_segments`	时间线片段列表。每项只支持 {start=..., end=...}；可写 0.5s 这类秒值，也可直接写微秒整数。	是	无
写入开始时间	`write_start_time`	从目标轨道的这个时间点开始写入；不填时从 0 秒开始。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`草稿名`	string	否	未提供说明
`素材路径`	string	否	未提供说明
`轨道ID`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`素材ID`	string	否	未提供说明
`素材类型`	string	否	未提供说明
`片段数量`	integer	否	未提供说明
`写入后总时长`	integer	否	未提供说明
`素材总时长`	integer	否	未提供说明
`片段列表`	array	否	未提供说明

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