视频翻译接口文档
更新时间：2026-04-20
产品定价
| 规格 | 消耗类型 | 档位售价1 | 档位售价2 | 档位售价3 |
|---|---|---|---|---|
| 360p、720p、1k、2k、4k | 根据具体合成视频时长消耗（按s消耗） | 300元/30分钟 | 2500元/300分钟 | 7000元/1000分钟 |
接口说明
新增功能: 支持视频翻译
接口调用域名：https://open.xiling.baidu.com
接口鉴权和通用字段说明请查阅：接口通用说明
视频翻译接口采用异步任务模式。提交任务后会按目标语言拆分为多个子任务，可通过查询接口轮询结果，也可通过回调地址接收每个子任务的完成通知。
视频翻译时长仅支持本接口文档对应能力使用，不可用于其他接口。
接口列表
查询视频翻译可用语种
GET /api/digitalhuman/open/v1/video-translate/target-languages
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| items | string[] | 支持的语言列表 |
返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "items": [
8 "English",
9 "Japanese",
10 "Spanish"
11 ]
12 }
13}提交视频翻译任务
POST /api/digitalhuman/open/v1/video-translate
Content-Type: application/json;charset=utf-8
请求参数
| 参数 | 类型 | 必填 | 说明 | 备注 |
|---|---|---|---|---|
| target_languages | string[] | 是 | 目标语言列表 | |
| speaker_num | int | 否 | 待翻译视频中发音人数量，不传该值时系统会自动检测 | |
| translate_audio_only | bool | 否 | 仅翻译音频，不传该值时默认 false | 仅翻译音频，忽略人脸，仅翻译此视频中的语音轨道，适用于旁白、配音等场景 |
| enable_dynamic_duration | bool | 否 | 自适应时长，不传该值时默认 true | 拉伸或缩短视频的某些部分，以增强不同语速语言之间的对话流畅性和翻译质量 |
| enable_caption | bool | 否 | 是否需要字幕，不传该值时默认 false | |
| name | string | 否 | 视频名称，字符长度 < 100 | 结束后的视频名称为：目标语言 + "-" + name；若为空则使用系统生成名称 |
| video_url | string | 是 | 待翻译视频 URL | 支持格式：MP4/MOV/WebM、360P-4K、时长不超过 30 分钟，且 URL 可访问可下载 |
| callback_url | string | 否 | 视频翻译结束后回调通知的 URL | 每个视频子任务成功或失败时都会单独回调 |
返回参数
| 参数 | 类型 | 说明 |
|---|---|---|
| items | array[] | 视频翻译任务列表 |
| task_id | string | 翻译子任务的唯一标识符 |
| language | string | 该子任务的目标语言 |
请求示例
JSON
1{
2 "target_languages": [
3 "English",
4 "Japanese"
5 ],
6 "translate_audio_only": true,
7 "enable_dynamic_duration": true,
8 "video_url": "https://example.com/demo.mp4",
9 "callback_url": "https://example.com/callback"
10}返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "items": [
8 {
9 "task_id": "vt-english-001",
10 "language": "English"
11 },
12 {
13 "task_id": "vt-japanese-001",
14 "language": "Japanese"
15 }
16 ]
17 }
18}回调参数
- task_type: video_translate
- data:
| 参数名 | 类型 | 是否必填 | 描述 |
|---|---|---|---|
| task_id | string | 是 | 该翻译视频的唯一标识符 |
| name | string | 是 | 视频名称 |
| language | string | 是 | 视频翻译目标语言 |
| status | string | 是 | 任务状态：SUCCEEDED、FAILED、GENERATING、WAITING |
| video_url | string | 否 | 翻译成功的视频 URL |
| caption_url | string | 否 | 字幕文件地址，只有当 enable_caption 为 true 时，该字段有值 |
| error_message | string | 否 | 翻译失败时的失败原因 |
回调示例
JSON
1{
2 "code": 0,
3 "msg": "ok",
4 "task_type": "video_translate",
5 "data": {
6 "task_id": "vt-d6b6472bcf724d0399e06d1390cb964e",
7 "name": "video-translate-1",
8 "language": "English",
9 "status": "SUCCEEDED",
10 "video_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.mp4",
11 "caption_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.ass",
12 "error_message": ""
13 }
14}查询视频翻译任务结果
GET /api/digitalhuman/open/v1/video-translate
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务 ID |
返回参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 该翻译视频的唯一标识符 |
| name | string | 是 | 视频名称 |
| language | string | 是 | 视频翻译目标语言 |
| status | string | 是 | 任务状态：SUCCEED、FAILED、GENERATING、WAITING |
| video_url | string | 否 | 翻译成功的视频 URL |
| caption_url | string | 否 | 字幕文件地址，只有当 enable_caption 为 true 时，该字段有值 |
| error_message | string | 否 | 翻译失败时的失败原因 |
请求示例
Plain
1GET /api/digitalhuman/open/v1/video-translate?task_id=vt-d6b6472bcf724d0399e06d1390cb964e返回示例
JSON
1{
2 "code": 0,
3 "message": {
4 "global": "success"
5 },
6 "result": {
7 "task_id": "vt-d6b6472bcf724d0399e06d1390cb964e",
8 "name": "video-translate-1",
9 "language": "English",
10 "status": "SUCCEED",
11 "video_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.mp4",
12 "caption_url": "https://xiling-dh.bj.bcebos.com/example/sample_0.ass",
13 "error_message": ""
14 }
15}评价此篇文章