产品动态
产品公告
AI 配音（不含擦除）接入
AI 配音功能简介
AI 配音功能可以将视频原配音替换为翻译语言 AI 配音，并将翻译语言字幕压制至视频画面上。发起 AI 配音任务，需要使用以下两个文件作为输入：
1. 视频文件。配音任务不进行字幕擦除，建议使用无字幕视频。
2. 字幕文件或角色标记文件（Speaker 文件）。
说明：
计费说明
发起 AI 配音任务，收取 「AI 配音（克隆音色）」+ 「压制字幕」费用，其中压制字幕可选。
说明：
AI 配音功能默认使用克隆音色。当前标准音色能力升级中，暂仅开放内测，如有需求您可以联系商务或 提交工单 获得支持。
若使用标准音色，收取「AI 配音（标准音色）」+ 「压制字幕」费用，其中压制字幕可选。
发起 AI 配音任务
接入前置操作
在接入 AI 配音前，为正常使用 MPS 产品，您需要完成以下前置操作：腾讯云账号注册和登录、开通 MPS 产品、授权服务角色。
方式1：控制台发起任务
1. 进入控制台 创建任务 页面，依次选择输入文件路径、配置编排处理流程、输出路径。
2. 在编排配置中，选择媒体 AI - 智能分析节点。
3. 在右侧弹出页面中，选择32号预设模板。开启“更多设置 - 扩展参数”，根据下文 扩展参数说明，传入所需参数。
说明：
发起 AI 配音任务，必须在扩展参数中传入字幕文件路径或 Speaker 文件路径，否则任务会失败。
MPS 控制台会自动转义，请直接传入 JSON 数据，不要传入转义后的字符串，否则任务会失败。
方式2：API 发起任务
调用 ProcessMedia 接口 ，选择 AiAnalysisTask 任务，将 Definition 设置为32（预设模板 ID），ExtendedParameter 填写扩展参数，通过该参数实现 AI 配音能力，取值见下文 扩展参数说明。ProcessMedia 的 JSON 示例如下：
{"InputInfo":{ //输入视频路径，请替换为您的原始视频（建议使用无字幕视频，纯配音服务不会做字幕擦除）"Type":"URL","UrlInputInfo":{"Url":"https://test-1234567.cos.ap-nanjing.myqcloud.com/mps_test/myvideo.mp4"}},"OutputStorage":{ //输出COS存储桶，请替换"Type":"COS","CosOutputStorage":{"Bucket":"test","Region":"ap-nanjing"}},"OutputDir":"/mps_test/output/",//输出文件夹路径，请替换"AiAnalysisTask":{"Definition":32, //预设模板ID，填 32 即可"ExtendedParameter":"{\\"dubbing\\":{\\"speakerUrl\\":\\"https://mycloud.com/path/to/file.json\\"}}" //扩展参数，必传，用于指定speaker文件路径、字幕样式等参数},"TaskNotifyConfig":{ //事件回调通知配置，可选"NotifyType":"URL","NotifyUrl":"http://www.qq.com/callback"}}
建议您通过 API Explorer 实现快速验证。您可以将上述 JSON 复制到 API Explorer 的 JSON 模式中，切换至“表单”模式可以自动解析，调整输入输出路径等必要参数后，再单击发起调用即可。
在 API Explorer 表单和 JSON 两种输入模式下，ExtendedParameter 的位置示意如下：
注意：
使用 API Explorer 的表单模式填写 ExtendedParameter 时，需要直接传入 JSON，不用转换成字符串。但使用 API Explorer 的 JSON 模式或直接使用 API 接口，则必须传入转义后的字符串。
API Explorer 表单模式，ExtendedParameter 传入 JSON 即可：
API Explorer JSON 模式，ExtendedParameter 则需要传入转义后的字符串，示例：
{\\"dubbing\\":{\\"speakerUrl\\":\\"https://mycloud.com/path/to/file.json\\"}}
其他说明
ExtendedParameter 扩展参数说明
ExtendedParameter 用于对 AI 配音任务进行个性设置，全部可选参数及其说明参考：参数 | 类型 | 必填 | 描述 |
speakerUrl | string | 否 | |
srcLang | string | 否 | 源语言，speakerUrl 模式下可不填。 |
dstLangs | list<string> | 否 | 配音目标语言，speakerUrl 模式下可不填。 |
subtitleUrls | json | 否 | 输入字幕 Urls，和 speakerUrl 二选一。 |
subtitleUrls.srcSubtitleUrl | string | 否 | 原字幕 Url. |
subtitleUrls.dstSubtitleUrls | json | 否 | 目标字幕 Urls，key 为语言，value 为字幕 Url。 |
subtitle | json | 否 | 输出字幕相关参数。 |
subtitle.embed | bool | 否 | 是否压制字幕，默认开启。 |
subtitle.style | json | 否 | 字幕样式，启用字幕压制时生效。 |
subtitle.style.font | string | 否 | 字体，不填或填"auto"时使用默认字体。 |
subtitle.style.fontSize | float | 否 | 字体大小，默认值 50 px。 |
subtitle.style.marginV | float | 否 | 底部距离，默认值 50 px。 |
outputPattern | string | 否 | 输出文件名前缀，不传则前缀默认为 dub，文件全名为 dub_{unixtime}.{format}。 |
使用 speakerUrl 请求参数示例：
{"dubbing": {"speakerUrl": "https://mycloud.com/path/to/file.json", // 必传，speaker 文件 URL"subtitle": {"embed": true, // 是否压制字幕，默认开启"style": { // 字幕样式，启用字幕压制时生效"font": "kai.ttf", // 字体"fontSize": 50, // 字体大小,默认值50px"marginV": 50 // 底部距离,默认值50}},"outputPattern": "filename" // 非必传，输出文件名前缀}}
使用 subtitleUrls 请求参数示例：
{"dubbing": {"srcLang": "zh","dstLangs": ["ja"],"subtitleUrls": {"srcSubtitleUrl": "https://test/zh.vtt", // 原字幕"dstSubtitleUrls": {"ja": "https://test/ja.vtt" // 目标字幕}},"subtitle": {"embed": true, // 是否压制字幕，默认开启"style": { // 字幕样式，启用字幕压制时生效"font": "auto", // 字体, auto时根据语言自动匹配"fontSize": 0.04, // 字体大小"marginV": 0.15 // 字幕距离底部位置}},"outputPattern": "filename" // 非必传，输出文件名前缀}}
注意：
Speaker 文件或字幕文件中的单句字幕时长需不小于0.15秒。
Speaker 文件说明
数据格式
Speaker 文件指带有字幕及对应角色信息的 JSON 格式文件，数据格式如下：
{"SrcLang": "zh","DstLangs": ["en"],"Speakers": [{"Id": "speaker_0","Gender": "male"},{"Id": "speaker_1","Gender": "female"}],"Clips": [{"TextStartTime": "00:00:00.100","TextEndTime": "00:00:00.600","SpeakerId": "speaker_0","SrcText": "没谁","DstTexts": {"en": "No one"}},{"TextStartTime": "00:00:01.0","TextEndTime": "00:00:01.200","SpeakerId": "speaker_1","SrcText": "早上好","DstTexts": {"en": "Morning"}}]}
参数 | 是否必填 | 类型 | 说明 |
SrcLang | 是 | string | |
DstLangs | 是 | list<string> | |
Speakers[i].Id | 是 | string | 说话人 ID。 |
Speakers[i].Gender | 是 | string | 说话人性别，取 male 或 female。 |
Clips[i].TextStartTime | 是 | string | 字幕切片开始时间戳，时:分:秒.毫秒。 |
Clips[i].TextEndTime | 是 | string | 字幕切片结束时间戳，时:分:秒.毫秒。 |
Clips[i].SpeakerId | 是 | string | 字幕切片对应的说话人 ID。 |
Clips[i].SrcText | 是 | string | 字幕切片源语言。 |
Clips[i].DstTexts | 是 | map<string,string> | 字幕切片翻译语言，当前仅支持单种语言。 |
修改 Speaker 文件示例
修改标记不正确的说话人（SpeakerId），可以避免串音现象。
修改过短时间戳，避免配音语速过快问题。
修改译文，满足更地道、更口语化的需求。
AI 配音支持语种
说明：
选用 AI 配音-克隆音色，支持以下语种：
语种 | Code | 是否可用于源语言（SrcLang） | 是否可用于译制目标语言（DstLangs） |
中文 (Chinese) | zh | ✓ | ✓ |
英语 (English) | en | ✓ | ✓ |
日语 (Japanese) | ja | ✓ | ✓ |
德语 (German) | de | ✓ | ✓ |
法语 (French) | fr | ✓ | ✓ |
韩语 (Korean) | ko | ✓ | ✓ |
俄语 (Russian) | ru | ✓ | ✓ |
乌克兰语 (Ukrainian) | uk | ✓ | ✓ |
葡萄牙语 (Portuguese) | pt | ✓ | ✓ |
意大利语 (Italian) | it | ✓ | ✓ |
西班牙语 (Spanish) | es | ✓ | ✓ |
印度尼西亚语 (Indonesian) | id | ✓ | ✓ |
荷兰语 (Dutch) | nl | ✓ | ✓ |
土耳其语 (Turkish) | tr | ✓ | ✓ |
菲律宾语 (Filipino) | fil | ✓ | ✓ |
马来语 (Malay) | ms | ✓ | ✓ |
希腊语 (Greek) | el | ✓ | ✓ |
芬兰语 (Finnish) | fi | ✓ | ✓ |
克罗地亚语 (Croatian) | hr | ✓ | ✓ |
斯洛伐克语 (Slovak) | sk | ✓ | ✓ |
波兰语 (Polish) | pl | ✓ | ✓ |
瑞典语 (Swedish) | sv | ✓ | ✓ |
印地语 (Hindi) | hi | ✓ | ✓ |
保加利亚语 (Bulgarian) | bg | ✓ | ✓ |
罗马尼亚语 (Romanian) | ro | ✓ | ✓ |
阿拉伯语 (Arabic) | ar | ✓ | ✓ |
捷克语 (Czech) | cs | ✓ | ✓ |
丹麦语 (Danish) | da | ✓ | ✓ |
泰米尔语 (Tamil) | ta | ✓ | ✓ |
匈牙利语（Hungarian） | hun | ✓ | ✓ |
越南语（Vietnamese） | vi | ✓ | ✓ |
查询任务结果
AI 配音任务会输出处理后的视频文件、精调后的 Speaker 文件（在配音的同时，会对原始 Speaker 文件中的译文做精简逻辑，保证配音的语速正常，避免语速过快的情况，因此会生成新的 Speaker 文件），保存在任务配置的输出路径下。
控制台查询结果
1. 您可以在控制台 任务管理 页面查看任务状态，当子任务状态为“成功”时，单击回调 JSON。
2. 可以在输出信息中找到输出文件路径。
如果使用 COS 作为输出路径，您可以在 MPS 控制台的编排管理 > COS Bucket > 输出 Bucket 页面中找到输出文件。文件名类似"dub-xxx.mp4"、"dub-xxx.json"的文件即为 AI 配音处理后的视频文件、Speaker文件。
事件通知回调
在使用 ProcessMedia 发起媒体处理任务时，您可以通过 TaskNotifyConfig 参数配置事件回调。当任务处理完成后，会通过配置的回调信息回调任务结果，您可以通过 ParseNotification 解析事件通知结果。下方列出了相关数据结构以供参考。
调用接口查询任务结果
在使用 ProcessMedia 发起媒体处理任务后，会返回任务 ID（TaskId），例如：24000022-WorkflowTask-b20a8exxxxxxx1tt110253、24000022-ScheduleTask-774f101xxxxxxx1tt110253。调用 DescribeTaskDetail 接口，输入任务 ID 即可获取任务结果，您需要解析 WorkflowTask ->AiAnalysisResultSet > DubbingTask > Output 字段获取任务结果。下方列出了相关数据结构以供参考。
相关数据结构
常见问题
如何获得无痕视频？
是否支持输入视频，一站式进行去字幕+翻译字幕+压制字幕+AI 配音处理？
如何通过 SRT/VTT 格式字幕文件生成 Speaker 文件？
支持 SRT 或 VTT 格式字幕文件，使用示例如下：
提供双语字幕文件（原字幕和翻译字幕在同一个字幕文件里）。
python3 subtitle2speaker.py input.srt output.json --src_lang "zh" --dst_langs "en"
提供两个单语字幕文件（原字幕和翻译字幕不在一个文件中）。
python3 subtitle2speaker.py input_src.vtt input_dst.vtt output.json --src_lang "zh" --dst_langs "en"
说明：
通过 SRT/VTT 格式字幕文件生成的 Speaker 文件，说话人 ID 都为默认值，您需要手动修改说话人信息，否则配音效果可能不符合预期。
文档反馈