一、概述
注意:说明:
注意:本能力为异步任务接口(async_generation)。提交请求后系统后台处理,不会立即返回配音视频,而是返回任务标识;需通过任务查询接口轮询处理状态与最终结果。
二、前提条件
·已 注册腾讯云 账号并开通 TokenHub 服务。
·已在 TokenHub 控制台 获取 API Key。
三、调用流程
AI 配音为耗时任务,接口采用异步调用模式,统一分两步:
1. 提交任务:调用能力接口(model / input_url / src_language / dst_language 等),成功返回 id(任务 ID)。
2. 轮询结果:携带 id 调用 查询任务结果 接口,建议每 3–5 秒轮询一次,直至 status = completed(生成成功),从 output.result_url 获取翻译配音后的视频地址。
注意:说明:
四、支持模型
| 模型名称 | model(调用参数) | 能力说明 |
| WAND AI 配音-克隆音色(WAND-Dubbing-Clone-V1) | wand-dubbing-clone-v1 | 翻译视频字幕与配音,输出目标语言视频。 |
| WAND AI 配音-克隆音色-加强版(WAND-Dubbing-Clone-V2) | wand-dubbing-clone-v2 | 翻译视频字幕与配音,输出目标语言视频。最新模型版本,相比 v1 表达措辞更自然,高保真还原原声情绪、语气与说话韵律,复刻质感更贴近真人原版。 |
五、接口信息
| 项 | 值 |
| 地址 | https://tokenhub.tencentmaas.com/v1/wand/dubbing/async_generation |
| 方法 | POST |
| Content-Type | application/json |
| 鉴权 | Authorization: Bearer YOUR_API_KEY |
六、请求示例
cURLcurl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/dubbing/async_generation' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H 'Content-Type: application/json' \\ -d '{ "model": "wand-dubbing-clone-v1", "input_url": "https://example.com/video.mp4", "src_language": "zh", "dst_language": "en" }'
七、请求参数
| 参数 | 类型 | 必选 | 说明 |
| model | string | 是 | 配音模型,可选 wand-dubbing-clone-v1 / wand-dubbing-clone-v2 |
| input_url | string | 是 | 视频(单个):支持 URL 和 Base64格式,视频格式:mp4/mov/m4v;单个视频时长 ≤ 45分钟;1. Base64:单个视频大小 ≤ 75MB,转为 Base64大小 ≤ 100MB;格式要求:data:video/<视频格式>;base64,<Base64 编码>。注:视频为 mov 时视频格式填 quicktime。2. URL:单个文件大小 ≤ 1GB;需要公网可访问(http/https)。 |
| src_language | string | 否 | 源语言代码,如 zh(中文)、en(英文)等,具体支持语言请参见 附录:支持语种,默认 zh |
| dst_language | string | 否 | 目标语言代码,如 zh(中文)、en(英文)等,具体支持语言请参见 附录:支持语种,默认 en |
八、返回示例
注意:说明:
注意:本接口为异步任务,提交成功后返回任务标识(id),用于后续查询。
{ "request_id": "req-xxx", "id": "th_xxxx_xxxx_dubbing_xxxxxxxxx", "object": "dubbing.task", "created_at": 1753172400, "status": "queued"}
九、返回字段
| 字段 | 类型 | 说明 |
| id | string | 任务标识,用于查询任务状态与最终结果。 |
| request_id | string | 请求标识。 |
| object | string | 对象类型,固定 dubbing.task。 |
| status | string | 任务状态:queued(已提交)/ in_progress(处理中)/ completed(完成)/ failed(失败)。 |
| created_at | int | 创建时间戳。 |
十、异步任务查询
提交 async_generation 后,需通过任务查询接口轮询处理状态,待任务完成后获取翻译配音的视频结果。
十一、接口信息
| 项 | 值 |
| 地址 | https://tokenhub.tencentmaas.com/v1/wand/dubbing/tasks/{id}说明:{id} 为提交返回的任务标识。 |
| 方法 | GET |
| 鉴权 | Authorization: Bearer YOUR_API_KEY |
十二、请求示例
cURLcurl -X GET 'https://tokenhub.tencentmaas.com/v1/wand/dubbing/tasks/YOUR_ID' \\ -H 'Authorization: Bearer YOUR_API_KEY'
十三、返回说明
返回指定任务的状态与结果。任务成功时返回翻译配音后的视频地址等结果。
十四、返回示例
{ "request_id": "req-xxx", "id": "th_xxxx_xxxx_dubbing_xxxxxxxxx", "object": "dubbing.task", "status": "completed", "output": { "result_url": "https://xxx.mp4" }, "usage": { "total_tokens": 118240, "duration": 12.5 }}
十五、返回字段
| 字段 | 类型 | 说明 |
| id | string | 任务标识,用于查询任务状态与最终结果。 |
| request_id | string | 请求标识。 |
| status | string | 任务状态:queued(已提交)/ in_progress(处理中)/ completed(完成)/ failed(失败)等,以 TokenHub 实际返回为准。 |
| object | string | 对象类型,固定 dubbing.task。 |
| created_at | int | 创建时间戳。 |
| error | object | 错误信息,仅任务状态为 failed 时存在。 |
| error.code | string | 6 位业务错误码,前 3 位 = HTTP 状态码。 |
| error.type | string | 错误类型枚举。 |
| error.message | string | 英文错误描述。 |
| error.message_zh | string | 中文错误描述。 |
| error.source | string | 错误来源:client(客户端)/ gateway(网关)/ upstream(上游)。 |
| error.upstream_status | int | 仅 source=upstream 时存在,后端原始 HTTP 状态码。 |
| error.request_id | string | 请求唯一标识。 |
| output | object | 任务结果,仅任务状态为 completed 时存在。 |
| output.result_url | string | 结果视频地址。 |
| usage | object | 用量信息,仅任务状态为 completed 时存在。 |
| usage.total_token | int | 本次任务消耗 token 总数。 |
| usage.duration | float | 本次任务输入时长(秒)。 |
十六、附录:支持语种
WAND AI 配音支持以下语种:
| 语种 | Code | 是否可用于源语言(src_language) | 是否可用于翻译目标语言(dst_language) |
| 中文 (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 | ✓ | ✓ |
| 泰语(Thai) | th | ✓ | ✓ |
| 粤语(Cantonese) | yue | ✓ | ✓ |
十七、错误码
请参见 API 错误码说明。