帮你快速理解、总结文档立即下载
文档中心>大模型服务平台 TokenHub>调用指南>语音模型>AI 配音>WAND AI 配音（WAND-Dubbing-Clone）

WAND AI 配音（WAND-Dubbing-Clone）

最近更新时间：2026-09-29 16:23:57
我的收藏

本页目录：

概述

TokenHub 已上线 wand-dubbing-clone 系列 AI 配音（视频翻译配音）模型，相关能力由 腾讯云 WAND 提供。
功能说明：上传视频 → 识别并翻译视频字幕与语音内容 → 以目标语言重新生成配音及字幕 → 输出翻译后的视频。适用于影视、课程、短视频等内容的多语言翻译与本地化。具体价格请参见 TokenHub 模型价格说明。
说明：
本能力为异步任务接口（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 获取翻译配音后的视频地址。
说明：
任务创建成功后请勿重复提交，通过轮询获取结果即可。
通用响应格式：request_id（请求标识）、object（对象类型）、status（任务状态）、error（错误对象，仅失败时存在）。

支持模型

模型名称
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

请求示例

cURL
curl -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

请求示例

cURL
curl -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 错误码说明。
中国站