文档中心>API 中心

提交视频转译任务

最近更新时间:2025-04-25 02:12:36

我的收藏

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。

命令行工具

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