剪映剪辑助手-音频

显示全部

音频

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

添加音频片段

add_jianying_audio

剪映剪辑助手音频

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

写法：添加音频片段音频路径=<音频路径> [开始时间=<开始时间>] [持续时长=<持续时长>] [轨道=<轨道>] [素材开始时间=<素材开始时间>] [音量=<音量>] [原片段后移=<原片段后移>]

保存为

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

正确示例

添加音频片段 音频路径="D:/demo.mp3" 开始时间=1

错误示例

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

为什么错：漏写了必填参数：音频路径。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
音频路径	`audio_path`	要加入草稿的本地音频路径。	是	无
开始时间	`start_time`	放到时间线上的开始时间。	否	无
持续时长	`duration`	片段持续时长。	否	无
轨道	`track_name`	目标音频轨道；不填时自动使用默认轨道名。	否	无
素材开始时间	`source_start`	从音频素材内部什么时间开始截取。	否	0
音量	`volume`	客户端 dB 音量值；0 为默认音量。	否	0.0
原片段后移	`move_original_segments`	是否先给新片段腾位置；是=命中的原片段整体后移，如开始时间落在片段内部则先切分再后移；否=按覆盖语义处理原片段。	否	False

返回结果

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

返回结果

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

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

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

设置音频属性

set_jianying_audio_attributes

剪映剪辑助手音频

用途：设置指定音频片段或带音频的视频片段的音频属性。

写法：设置音频属性 [轨道=<轨道>] [片段序号=<片段序号>] [音量=<音量>] [淡入时长=<淡入时长>] [淡出时长=<淡出时长>] [响度统一=<响度统一>] [目标响度=<目标响度>] [音色=<音色>] [场景音=<场景音>] [批量失败继续=<批量失败继续>]

保存为

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

正确示例

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

错误示例

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

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标轨道，支持音频轨，也支持带音频的视频轨。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
音量	`volume`	客户端 dB 音量值；0 为默认音量。不填则不修改音量。	否	无
淡入时长	`fade_in`	音频淡入时长。不填则不修改淡入淡出。	否	无
淡出时长	`fade_out`	音频淡出时长。不填则不修改淡入淡出。	否	无
响度统一	`loudness_normalize`	响度统一开关；开启后写入最小响度材料，剪映可自动补全分析字段。	否	无
目标响度	`target_loudness`	响度统一目标响度，默认 -23.0。	否	-23.0
音色	`tone`	音色名称，对应客户端声音效果里的音色，例如小孩、机器人、女生。	否	无
场景音	`audio_effect`	场景音名称，对应客户端声音效果里的场景音，例如回音、低保真、麦霸。	否	无
批量失败继续	`continue_on_item_error`	批量命中时遇到失败片段是否跳过并继续处理其它命中片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`目标片段数量`	integer	否	未提供说明
`目标片段列表`	array	否	未提供说明
`失败片段数量`	integer	否	未提供说明
`失败片段列表`	array	否	未提供说明
`已设置音量`	boolean	否	未提供说明
`已设置淡入淡出`	boolean	否	未提供说明
`已设置响度统一`	boolean	否	未提供说明
`已设置音色`	boolean	否	未提供说明
`已设置场景音`	boolean	否	未提供说明

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

添加Edge配音

add_jianying_edge_tts_audio

剪映剪辑助手音频

用途：只使用 Edge TTS 把文本转成配音音频并导入当前剪映草稿的音频轨。

写法：添加Edge配音配音文本=<配音文本> [音色=<音色>] [开始时间=<开始时间>] [轨道=<轨道>] [音量=<音量>] [原片段后移=<原片段后移>] [同时生成字幕=<同时生成字幕>] [文本轨道名=<文本轨道名>] [字号=<字号>] [位置=<位置>]

保存为

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

正确示例

添加Edge配音 配音文本="示例值" 音色="示例值"

错误示例

添加Edge配音 音色="示例值"

为什么错：漏写了必填参数：配音文本。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
配音文本	`text`	要朗读的配音文本；如果传入本地 .txt/.md 文本文件路径且文件存在，会先读取文件内容再配音。	是	无
音色	`speaker`	用于推断男女声的音色标识；Edge 模式下不会精确复刻剪映音色，只按男女声选择近似音色。	否	zh_male_huoli
开始时间	`start_time`	放到时间线上的开始时间；不填时默认接到目标音频轨尾部。	否	无
轨道	`track_name`	目标音频轨道；不填时沿用当前默认音频轨。	否	无
音量	`volume`	客户端 dB 音量值；0 为默认音量。	否	0.0
原片段后移	`move_original_segments`	是否先给新片段腾位置；是=命中的原片段整体后移，如开始时间落在片段内部则先切分再后移；否=按覆盖语义处理原片段。	否	False
同时生成字幕	`generate_subtitle`	是否在导入配音的同时，顺手新增一条同文案字幕。默认 False。	否	False
文本轨道名	`subtitle_track_name`	生成字幕时写入的目标文本轨道名。	否	Subtitles
字号	`font_size`	生成字幕时使用的字号。	否	5.0
位置	`position`	生成字幕时使用的位置；填写坐标字符串 "x,y"。	否	0,-600

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`配音文本`	string	否	未提供说明
`音色`	string	否	未提供说明
`生成后端`	string	否	未提供说明
`生成音频路径`	string	否	未提供说明
`已生成字幕`	boolean	否	未提供说明
`文本轨道名`	string	否	未提供说明
`字幕片段ID`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`素材ID`	string	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明
`原片段后移`	boolean	否	未提供说明

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