大模型服务平台 TokenHub WAND AI 配音（WAND

概述
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（需可公网访问）
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_token": 118240
  }
}
返回字段
字段
类型
说明
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 总数。
附录：支持语种
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
✓
✓
错误码
请参见 API 错误码说明。

WAND AI 配音（WAND-Dubbing-Clone）

本页目录：

概述

前提条件

调用流程

支持模型

发起异步配音任务

接口信息

请求示例

请求参数

返回示例

返回字段

异步任务查询

接口信息

请求示例

返回说明

返回示例

返回字段

附录：支持语种

错误码

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

参数	类型	必选	说明
`model`	string	是	配音模型，可选 `wand-dubbing-clone-v1` / `wand-dubbing-clone-v2`
`input_url`	string	是	待翻译视频的 URL（需可公网访问）
`src_language`	string	否	源语言代码，如 `zh`（中文）、`en`（英文）等，具体支持语言请参见附录：支持语种，默认 `zh`
`dst_language`	string	否	目标语言代码，如 `zh`（中文）、`en`（英文）等，具体支持语言请参见附录：支持语种，默认 `en`

字段	类型	说明
`id`	string	任务标识，用于查询任务状态与最终结果。
`request_id`	string	请求标识。
`object`	string	对象类型，固定 dubbing.task。
`status`	string	任务状态：`queued`（已提交）/ `in_progress`（处理中）/ `completed`（完成）/ `failed`（失败）。
`created_at`	int	创建时间戳。

语种	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	✓	✓