1. 接口描述
接口请求域名: vtc.tencentcloudapi.com 。
支持音色种别列表
音色名称 | 性别 | 目标语言 | 音色ID |
---|---|---|---|
Florian Multilingual | 男 | 德语(德国) | 701001 |
Seraphina | 女 | 德语(德国) | 701002 |
Ada Multilingual | 女 | 英语(英国) | 701003 |
Ollie Multilingual | 男 | 英语(英国) | 701004 |
Ava Multilingual | 女 | 英语(美国) | 701005 |
Andrew Multilingual | 男 | 英语(美国) | 701006 |
Emma Multilingual | 女 | 英语(美国) | 701007 |
Brian Multilingual | 男 | 英语(美国) | 701008 |
Jenny Multilingual | 女 | 英语(美国) | 701009 |
Ryan Multilingual | 男 | 英语(美国) | 701010 |
Adam Multilingual | 男 | 英语(美国) | 701011 |
AlloyTurbo Multilingual | 男 | 英语(美国) | 701012 |
Amanda Multilingual | 女 | 英语(美国) | 701013 |
Brandon Multilingual | 男 | 英语(美国) | 701014 |
Christopher Multilingual | 男 | 英语(美国) | 701015 |
Cora Multilingual | 女 | 英语(美国) | 701016 |
Davis Multilingual | 男 | 英语(美国) | 701017 |
Derek Multilingual | 男 | 英语(美国) | 701018 |
Dustin Multilingual | 男 | 英语(美国) | 701019 |
Evelyn Multilingual | 女 | 英语(美国) | 701020 |
Lewis Multilingual | 男 | 英语(美国) | 701021 |
Lola Multilingual | 女 | 英语(美国) | 701022 |
Nancy Multilingual | 女 | 英语(美国) | 701023 |
NovaTurbo Multilingual | 女 | 英语(美国) | 701024 |
Phoebe Multilingual | 女 | 英语(美国) | 701025 |
Samuel Multilingual | 男 | 英语(美国) | 701026 |
Serena Multilingual | 女 | 英语(美国) | 701027 |
Steffan Multilingual | 男 | 英语(美国) | 701028 |
Arabella Multilingual | 女 | 西班牙语(西班牙) | 701029 |
Isidora Multilingual | 女 | 西班牙语(西班牙) | 701030 |
Tristan Multilingual | 男 | 西班牙语(西班牙) | 701031 |
Ximena Multilingual | 女 | 西班牙语(西班牙) | 701032 |
Remy Multilingual | 男 | 法语(法国) | 701033 |
Vivienne Multilingual | 女 | 法语(法国) | 701034 |
Lucien Multilingual | 男 | 法语(法国) | 701035 |
Alessio Multilingual | 男 | 意大利语(意大利) | 701036 |
Giuseppe Multilingual | 男 | 意大利语(意大利) | 701037 |
Isabella Multilingual | 女 | 意大利语(意大利) | 701038 |
Marcello Multilingual | 男 | 意大利语(意大利) | 701039 |
Masaru Multilingual | 男 | 日语(日本) | 701040 |
Hyunsu Multilingual | 男 | 韩语(韩国) | 701041 |
Macerio Multilingual | 男 | 葡萄牙语(巴西) | 701042 |
Thalita Multilingual | 女 | 葡萄牙语(巴西) | 701043 |
晓辰 多语言 | 女 | 中文(普通话) | 701044 |
晓晓 多语言 | 女 | 中文(普通话) | 701045 |
晓宇 多语言 | 女 | 中文(普通话) | 701046 |
云逸 多语言 | 男 | 中文(普通话) | 701047 |
Yunfan Multilingual | 男 | 中文(普通话) | 701048 |
Yunxiao Multilingual | 男 | 中文(普通话) | 701049 |
晓晓 方言 | 女 | 中文(普通话) | 701050 |
默认接口请求频率限制:20次/秒。
推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。
2. 输入参数
以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
Action | 是 | String | 公共参数,本接口取值:SubmitVideoTranslateJob。 |
Version | 是 | String | 公共参数,本接口取值:2024-02-23。 |
Region | 是 | String | 公共参数,详见产品支持的 地域列表。 |
VideoUrl | 是 | String | 视频地址URL。 格式要求:支持 mp4、mov 。 时长要求:【10-300】秒。 fps 要求:【15-60】fps 分辨率要求:单边像素要求在 【540~1920】 之间。 示例值:http://xxx/video.mp4 |
SrcLang | 是 | String | 源语言:zh(中文), en(英文) 示例值:zh |
DstLang | 是 | String | 目标语种: zh(简体中文)、en(英语)、ar(阿拉伯语)、de(德语)、es(西班牙语)、fr(法语)、id(印尼语)、it(意大利语)、ja(日语)、ko(韩语)、ms(马来语)、pt(葡萄牙语)、ru(俄语)、th(泰语)、tr(土耳其语)、vi(越南语) 示例值:ar(阿拉伯语) 示例值:en |
AudioUrl | 否 | String | 当音频 URL 不为空时,默认以音频驱动视频任务口型。 格式要求:支持 mp3、m4a、acc、wav 格式。 时长要求:【10~300】秒 大小要求:不超过 100M。 示例值:http://xxx/audio.mp3 示例值:http://xxx/audio.mp3 |
RemoveVocal | 否 | Integer | 是否需要去除VideoUrl或AudioUrl中背景音,取值范围:0-不需要,1-需要,默认0 。 示例值:0 |
Confirm | 否 | Integer | 是否需要确认翻译结果0:不需要,1:需要 示例值:1 |
LipSync | 否 | Integer | 是否开启口型驱动,0:不开启,1:开启。默认开启。 示例值:1 |
VoiceType | 否 | String | 音色种别:一种音色种别对应一种不同区域的音色 1)目标语种为小语种(非zh,en)时,该项为必填 2)目标语种为zh,en时,该项为非必填,若填入,则对应填入的音色 具体音色包含请见“支持音色种别列表” 示例值:701001 |
3. 输出参数
参数名称 | 类型 | 描述 |
---|---|---|
JobId | String | 视频转译任务的Job id 示例值:vlSYvQkMM0KwPuoakawm0tPrREwc2p7c |
RequestId | String | 唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。 |
4. 示例
示例1 提交中英视频转译失败案例
中英转译失败案例
输入示例
POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitVideoTranslateJob
<公共请求参数>
{
"VideoUrl": "https://xxx.com/url/xxx.mp4",
"SrcLang": "zh",
"DstLang": "zh",
"Confirm": 0,
"LipSync": 0
}
输出示例
{
"Response": {
"Error": {
"Code": "InvalidParameter.InvalidParameter",
"Message": "源语种(SrcLang)和目标语种(DstLang)不允许相同,请检查后重新输入"
},
"RequestId": "3787745f-b446-4b39-9471-9032a4c306ee"
}
}
示例2 提交中英视频转译成功案例
中英转译成功案例
输入示例
POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitVideoTranslateJob
<公共请求参数>
{
"VideoUrl": "https://xxx.com/url/xxx.mp4",
"SrcLang": "zh",
"DstLang": "en",
"Confirm": 0,
"LipSync": 0
}
输出示例
{
"Response": {
"JobId": "GLo7lni4PubX9xUwzesuKUOLJokVZ0ll",
"RequestId": "950a5a45-7bf5-4db3-aef1-dfedda487575"
}
}
示例3 提交小语种视频转译成功案例
小语种转译成功案例
输入示例
POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitVideoTranslateJob
<公共请求参数>
{
"VideoUrl": "https://xxx.com/url/xxx.mp4",
"SrcLang": "zh",
"DstLang": "de-DE",
"Confirm": 0,
"LipSync": 0,
"VoiceType": "701001"
}
输出示例
{
"Response": {
"JobId": "GLo7lni4PubX9xUwzesuKUOLJokVZ0ll",
"RequestId": "950a5a45-7bf5-4db3-aef1-dfedda487575"
}
}
示例4 提交小语种视频转译失败案例
小语种转译失败案例
输入示例
POST / HTTP/1.1
Host: vclm.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: SubmitVideoTranslateJob
<公共请求参数>
{
"VideoUrl": "https://xxx.com/url/xxx.mp4",
"SrcLang": "zh",
"DstLang": "de-DE",
"Confirm": 0,
"LipSync": 0
}
输出示例
{
"Response": {
"Error": {
"Code": "InvalidParameter.InvalidParameter",
"Message": "音色种别不能为空"
},
"RequestId": "3787745f-b446-4b39-9471-9032a4c306ee"
}
}
5. 开发者资源
腾讯云 API 平台
腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台,方便您从同一入口查询及使用腾讯云提供的所有 API 服务。
API Inspector
用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况,并自动生成各语言版本的 API 代码,也可前往 API Explorer 进行在线调试。
SDK
云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。
- Tencent Cloud SDK 3.0 for Python: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Java: GitHub, Gitee
- Tencent Cloud SDK 3.0 for PHP: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Go: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Node.js: GitHub, Gitee
- Tencent Cloud SDK 3.0 for .NET: GitHub, Gitee
- Tencent Cloud SDK 3.0 for C++: GitHub, Gitee
- Tencent Cloud SDK 3.0 for Ruby: GitHub, Gitee
命令行工具
6. 错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 描述 |
---|---|
FailedOperation.AudioDecodeFailed | 音频解码失败。 |
FailedOperation.DownloadError | 文件下载失败。 |
FailedOperation.RequestTimeout | 后端服务超时。 |
FailedOperation.ServerError | 系统内部错误。 |
FailedOperation.VideoDurationExceed | 视频时长超限制。 |
FailedOperation.VideoFpsExceed | 视频Fps超限制。 |
FailedOperation.VideoResolutionExceed | 视频分辨率超限制。 |
FailedOperation.VideoSizeExceed | 视频分辨率超限制。 |
InvalidParameter.InvalidParameter | 参数不合法。 |
InvalidParameterValue.UrlIllegal | URL格式不合法。 |
RequestLimitExceeded.JobNumExceed | 当前并发数已超上限 |
ResourceUnavailable.Freeze | 账号已被冻结。 |
ResourceUnavailable.InArrears | 账号已欠费。 |
ResourceUnavailable.IsOpening | 服务正在开通中,请稍等。 |
ResourceUnavailable.NotExist | 计费状态未知,请确认是否已在控制台开通服务。 |
ResourceUnavailable.NotReady | 服务未开通。 |
ResourcesSoldOut.ChargeStatusException | 账号已欠费。 |