大模型服务平台 TokenHub WAND AI 配音(WAND-Dubbing-Clone)

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 获取翻译配音后的视频地址。

注意:说明:

四、支持模型

模型名称 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 错误码说明。

赞 (0)
上一篇 4天前
下一篇 4天前