提交视频转译任务

1. 接口描述

此接口处于预下线状态。

预计下线时间：2026-09-27 19:41:28

接口请求域名： 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次/秒。

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: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Java: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for PHP: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Go: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Node.js: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for .NET: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for C++: CNB, GitHub, Gitee
Tencent Cloud SDK 3.0 for Ruby: CNB, GitHub, Gitee

命令行工具

Tencent Cloud CLI 3.0

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	账号已欠费。

提交视频转译任务

本页目录：

1. 接口描述

支持音色种别列表

2. 输入参数

3. 输出参数

4. 示例

示例1 提交中英视频转译失败案例

输入示例

输出示例

示例2 提交中英视频转译成功案例

输入示例

输出示例

示例3 提交小语种视频转译成功案例

输入示例

输出示例

示例4 提交小语种视频转译失败案例

输入示例

输出示例

5. 开发者资源

腾讯云 API 平台

API Inspector

SDK

命令行工具

6. 错误码