剪映剪辑助手-字幕

显示全部

字幕

剪映剪辑助手 / 字幕类动作。

添加字幕片段

add_jianying_subtitle_segment

剪映剪辑助手字幕

用途：向当前草稿添加字幕片段，支持关键词标记、花字气泡和样品包。

写法：添加字幕片段字幕内容=<字幕内容> [开始时间=<开始时间>] [持续时长=<持续时长>] [轨道=<轨道>] [字号=<字号>] [位置=<位置>] [套用模板属性=<套用模板属性>] [套用预设文本=<套用预设文本>] [花字资源ID=<花字资源ID>] [气泡资源ID=<气泡资源ID>] [原片段后移=<原片段后移>]

保存为

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

正确示例

添加字幕片段 字幕内容="示例内容" 开始时间=1

错误示例

添加字幕片段 开始时间=1

为什么错：漏写了必填参数：字幕内容。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
字幕内容	`text`	字幕内容；可用 [[关键词]] 在文本里直接标记关键词，落盘时会自动去掉标记并写入 subtitle_keywords.range。	是	无
开始时间	`start_time`	字幕片段开始时间。	否	无
持续时长	`duration`	字幕片段持续时长。	否	3s
轨道	`track_name`	目标文本轨道。	否	无
字号	`font_size`	字幕字号。	否	5.0
位置	`position`	字幕位置；填写坐标字符串 "x,y"，例如 "120,-60"。	否	0,-600
套用模板属性	`template_property`	已保存文本属性名；填写后会在新建片段时直接套用模板属性。	否	无
套用预设文本	`preset_text_name`	剪映本机个人预设文本名；读取并套用对应样式、花字或气泡。	否	无
花字资源ID	`flower_resource_id`	花字资源ID；提供后会直接给新字幕片段挂花字。示例：7539407429763796249	否	无
气泡资源ID	`bubble_resource_id`	文字气泡资源ID；提供后会直接给新字幕片段挂气泡。	否	无
原片段后移	`move_original_segments`	是否先给新字幕片段腾位置。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`文本素材ID`	string	否	未提供说明
`开始时间`	integer	否	未提供说明
`持续时长`	integer	否	未提供说明
`结束时间`	integer	否	未提供说明
`文本内容`	string	否	未提供说明
`文本长度`	integer	否	未提供说明
`原片段后移`	boolean	否	未提供说明
`文字类型`	string	否	未提供说明
`新增文字效果列表`	array	否	未提供说明
`关键词数量`	integer	否	未提供说明

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

更新字幕片段内容

update_jianying_subtitle_segment_content

剪映剪辑助手字幕

用途：更新当前剪映草稿中指定字幕片段的整段字幕内容，并解析 [[关键词]] 标记。

写法：更新字幕片段内容新字幕内容=<新字幕内容> [轨道=<轨道>] [片段序号=<片段序号>] [重算样式范围=<重算样式范围>] [批量失败继续=<批量失败继续>]

保存为

默认保存主结果，通常就是 新字幕内容 这个字段。

正确示例

更新字幕片段内容 新字幕内容="示例内容" 轨道="示例名称"

错误示例

更新字幕片段内容 轨道="示例名称"

为什么错：漏写了必填参数：新字幕内容。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
新字幕内容	`text`	新的字幕内容；可用 [[关键词]] 直接标记关键词，落盘时会自动去掉标记并重写 subtitle_keywords.range。	是	无
轨道	`track_name`	目标文本轨道	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
重算样式范围	`recalc_style`	是否按新字幕长度重算样式 range。	否	True
批量失败继续	`continue_on_item_error`	批量命中时遇到失败片段是否跳过并继续处理其它命中片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`文本内容`	string	否	未提供说明
`新字幕内容`	string	否	未提供说明
`文本长度`	integer	否	未提供说明
`重算样式范围`	boolean	否	未提供说明
`关键词数量`	integer	否	未提供说明
`目标片段数量`	integer	否	未提供说明
`目标片段列表`	array	否	未提供说明
`失败片段数量`	integer	否	未提供说明
`失败片段列表`	array	否	未提供说明

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

导入字幕文件

add_jianying_subtitle_from_srt

剪映剪辑助手字幕

用途：把 SRT 字幕文件批量导入到当前草稿的文本轨。

写法：导入字幕文件 SRT文件路径=<SRT文件路径> [轨道=<轨道>] [时间偏移=<时间偏移>] [字号=<字号>] [位置=<位置>]

保存为

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

正确示例

导入字幕文件 SRT文件路径="D:/demo.txt" 轨道="示例名称"

错误示例

导入字幕文件 轨道="示例名称"

为什么错：漏写了必填参数：SRT文件路径。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
SRT文件路径	`subtitle_file_path`	SRT 字幕文件路径。	是	无
轨道	`track_name`	目标文本轨道。	否	无
时间偏移	`time_offset`	整体时间偏移。	否	0
字号	`font_size`	导入后的默认字号。	否	5.0
位置	`position`	字幕位置；填写坐标字符串 "x,y"。	否	0,-600

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`新增片段数量`	integer	否	未提供说明
`时间偏移`	integer	否	未提供说明

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

识别字幕

recognize_subtitle_to_segments

剪映剪辑助手字幕

用途：从当前剪映草稿的轨道或片段提取时间线音频，识别后按时间范围覆盖导入字幕轨。

写法：识别字幕 [轨道=<轨道>] [字幕轨道=<字幕轨道>] [片段序号=<片段序号>] [保存字幕文件=<保存字幕文件>] [过滤字词=<过滤字词>] [单句最大字数=<单句最大字数>]

保存为

默认保存主结果，通常就是 识别文本 这个字段。

正确示例

识别字幕 轨道='主视频轨' 字幕轨道='字幕轨' 保存为=结果

# 说明：识别整条来源轨道的音频，并覆盖导入这段时间范围内的字幕。

错误示例

识别字幕 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`source_track_name`	要识别的来源轨道；从这条轨道提取时间线音频。不填时默认使用当前轨道。当前只支持 30 分钟以内来源音频。	否	无
字幕轨道	`track_name`	导入到剪映后的目标文本轨道；不填时使用“字幕轨道”。轨道不存在时自动创建；已有轨道只覆盖本次识别时间范围内的旧字幕。	否	无
片段序号	`source_segment_index`	片段序号；支持单个序号、random/随机、A\|B\|C 随机单选。不填时默认取整条轨道全部片段。	否	无
保存字幕文件	`subtitle_file_path`	可选；把生成的字幕内容另存为这个 SRT 文件路径，自动补 .srt 后缀；已存在时直接覆盖。不填时不保留字幕文件。	否	无
过滤字词	`filter_words`	可选；额外要过滤的字词，使用逗号分隔。标点符号和默认口语词会自动过滤。	否	无
单句最大字数	`single_sentence_max_length`	单句最大字数，默认 15；填写范围不限，实际值会按腾讯识别接口支持范围生效。	否	15

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`字幕文件路径`	string \| null	是	未提供说明
`字幕文件已保留`	boolean	是	未提供说明
`字幕条数`	integer	是	未提供说明
`来源轨道`	string	是	未提供说明
`命中片段数量`	integer	是	未提供说明
`音频时长`	integer	是	未提供说明
`实际断句长度`	integer	是	未提供说明
`过滤后字幕条数`	integer	是	未提供说明
`识别文本`	string	是	未提供说明
`识别结果`	object	是	未提供说明
`导入结果`	object	是	未提供说明

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

设置字幕关键词样式

set_jianying_subtitle_keyword_style

剪映剪辑助手字幕

用途：设置指定字幕片段的关键词样式，并可直接给关键词范围设置花字。

写法：设置字幕关键词样式 [轨道=<轨道>] [片段序号=<片段序号>] [套用模板样式=<套用模板样式>] [套用预设文本=<套用预设文本>] [花字资源ID=<花字资源ID>] [字体=<字体>] [字号=<字号>] [字体颜色=<字体颜色>] [不透明度=<不透明度>] [加粗=<加粗>] [斜体=<斜体>] [下划线=<下划线>] [对齐方式=<对齐方式>] [字间距=<字间距>] [行间距=<行间距>] [描边宽度=<描边宽度>] [描边颜色=<描边颜色>] [批量失败继续=<批量失败继续>]

保存为

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

正确示例

设置字幕关键词样式 轨道="示例名称" 片段序号="示例值"

错误示例

设置字幕关键词样式 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	目标文本轨道。	否	无
片段序号	`segment_index`	轨道内片段选择表达式。支持单个序号、逗号并集、范围、倒数、all/全部、random/随机，以及用 \| 从候选里随机取 1 个；不填时默认取该轨道第 1 个片段。	否	无
套用模板样式	`style_name`	已保存样式包名；填写后会在当前关键词范围上套用模板样式，也兼容带文字样式的历史效果包。	否	无
套用预设文本	`preset_text_name`	剪映本机个人预设文本名；读取并转成关键词样式参数，气泡会自动忽略。	否	无
花字资源ID	`flower_resource_id`	花字资源ID；提供后只对当前字幕关键词范围生效。关键词范围固定按 subtitle_keywords.range 的 UTF-16 code unit 口径定位。气泡不支持局部关键词范围，因此这里不提供气泡参数。	否	无
字体	`font_name`	关键词字体。	否	无
字号	`font_size`	关键词字号。	否	无
字体颜色	`font_color`	关键词颜色。	否	无
不透明度	`alpha`	关键词不透明度。	否	无
加粗	`bold`	关键词是否加粗。	否	无
斜体	`italic`	关键词是否斜体。	否	无
下划线	`underline`	关键词是否下划线。	否	无
对齐方式	`align`	关键词对齐方式。	否	无
字间距	`letter_spacing`	关键词字间距。	否	无
行间距	`line_spacing`	关键词行间距。	否	无
描边宽度	`border_width`	关键词描边宽度。	否	无
描边颜色	`border_color`	关键词描边颜色。高级阴影和背景效果请改用样品模板或效果包。	否	无
批量失败继续	`continue_on_item_error`	批量命中时遇到失败片段是否跳过并继续处理其它命中片段。	否	False

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`片段序号`	integer	否	未提供说明
`片段ID`	string	否	未提供说明
`文本内容`	string	否	未提供说明
`目标片段数量`	integer	否	未提供说明
`目标片段列表`	array	否	未提供说明
`失败片段数量`	integer	否	未提供说明
`失败片段列表`	array	否	未提供说明

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

获取轨道字幕内容

get_jianying_track_subtitle_content

剪映剪辑助手字幕

用途：从当前剪映草稿的文本轨道读取字幕内容；不传轨道时默认读取第一条包含字幕片段的文本轨。

写法：获取轨道字幕内容 [轨道=<轨道>] [保存到文件=<保存到文件>] [内容格式=<内容格式>]

保存为

默认保存主结果，通常就是 字幕内容 这个字段。

正确示例

获取轨道字幕内容 轨道="示例名称" 保存到文件="示例值"

错误示例

获取轨道字幕内容 轨道="示例名称" 错误参数=1

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

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	可选；目标文本轨道。不填时默认取当前草稿里第一条包含字幕片段的文本轨。	否	无
保存到文件	`output_file_path`	可选；把字幕内容写入这个文件地址。	否	无
内容格式	`content_format`	输出内容格式；只支持 srt 或 txt，默认 srt。	否	srt

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`内容格式`	string	否	未提供说明
`字幕内容`	string	否	未提供说明
`字幕条数`	integer	否	未提供说明
`保存到文件`	string \| null	否	未提供说明

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

按字幕内容粗剪

rough_cut_jianying_by_subtitle_content

剪映剪辑助手字幕

用途：按 SRT 字幕内容直接重排当前草稿里指定音频轨或视频轨上的片段；传了文本轨道名时会同步导入字幕。

写法：按字幕内容粗剪轨道=<轨道> 字幕内容=<字幕内容> [文本轨道名=<文本轨道名>] [保存字幕文件=<保存字幕文件>] [句前留白=<句前留白>] [句后留白=<句后留白>]

保存为

默认保存主结果，通常就是 字幕内容 这个字段。

正确示例

按字幕内容粗剪 轨道="示例名称" 字幕内容="示例内容"

错误示例

按字幕内容粗剪 轨道="示例名称"

为什么错：漏写了必填参数：字幕内容。

展开查看参数和注意事项

中文参数	英文参数	用途	必填	默认值
轨道	`track_name`	要直接重排的音频轨或视频轨。	是	无
字幕内容	`subtitle_content`	支持直接传 SRT 内容，也支持传本地 SRT 文件地址。	是	无
文本轨道名	`subtitle_track_name`	可选；传了就把重排后的字幕导入这条文本轨，不传就只重排轨道。	否	无
保存字幕文件	`output_subtitle_file_path`	可选；把重排后的字幕时间轴另存为 SRT 文件。	否	无
句前留白	`lead_in_duration`	可选；每句字幕开始前额外保留的时长，支持 120ms、0.12s 这类写法。	否	无
句后留白	`tail_out_duration`	可选；每句字幕结束后额外保留的时长，支持 120ms、0.12s 这类写法。	否	无

返回结果

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

返回结果

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

字段路径	类型	必有	说明
`草稿路径`	string	否	未提供说明
`轨道名`	string	否	未提供说明
`字幕条数`	integer	否	未提供说明
`跳过字幕条数`	integer	否	未提供说明
`复制片段数量`	integer	否	未提供说明
`字幕内容`	string	否	未提供说明
`字幕文件路径`	string \| null	否	未提供说明
`字幕文件已保留`	boolean	否	未提供说明
`导入结果`	object \| null	否	未提供说明

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