概述
Tokenhub 已上线语音识别（ASR）能力，本文对应 WAND 非实时、同步语音识别接口，模型为
wand-asr-v1。接口接收音视频文件地址，同步返回识别文本结果。前提条件
已 注册腾讯云 账号并开通 TokenHub 服务。
已在 TokenHub 控制台 获取 API Key。
接口信息
项 | 值 |
地址 | https://tokenhub.tencentmaas.com/v1/wand/asrproxy/sync_transcribe |
方法 | POST |
Content-Type | application/json |
鉴权 | Authorization: Bearer YOUR_API_KEY |
支持模型
模型名称 | model（调用参数） | 能力说明 |
WAND-ASR-V1 | wand-asr-v1 | 语音识别（ASR），支持音视频文件转写为文本 |
请求体
请求示例
curl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/asrproxy/sync_transcribe' \\-H 'Authorization: Bearer YOUR_API_KEY' \\-H "Content-Type: application/json" \\-d '{"model": "wand-asr-v1","input_url": "https://cos.example.com/xxx.mp4"}'
请求参数
参数 | 类型 | 必选 | 说明 |
model | string | 是 | 模型名称，固定为 wand-asr-v1。 |
input_url | string | 二选一 | 待识别的音视频文件地址（支持常见音视频格式）。最大支持30分钟音频/视频；文件大小 <= 100MB；需要公网可访问（http/https）。 |
data | string | 二选一 | Base64格式，最大支持音频/视频时长 <= 30分钟；文件大小<=75MB， 转为 Base64大小 <= 100MB；格式要求：视频：<base64编码数据>； 音频：<base64编码数据>；与 input_url 同时传则以 data 为准。 |
source | string | 否 | 识别语种：zh / en 等；缺省时后端自动检测。 |
voice_encode_format | string | 否 | 音频编码：pcm / wav / ogg / mp3等；缺省 auto。 |
返回体
返回示例
{"id": "th_251416641_700001910665_asrproxy_2dc6dad8df55a082a5a17b01f2426a20","object": "asr.task","created_at": 1721808000,"status": "completed","request_id": "fd8a1c2f-feb6-48ff-b904-e14056693b9c","output": {"source": "zh","duration_ms": 15230,"text": "大家好，欢迎来到今天的会议 今天我们讨论产品规划","sentences": [{ "begin_ms": 500, "end_ms": 3200, "text": "大家好，欢迎来到今天的会议" },{ "begin_ms": 3500, "end_ms": 5800, "text": "今天我们讨论产品规划" }],"subtitle_url": "https://xxx.cos.ap-guangzhou.myqcloud.com/subtitle/xxx.srt"},"usage": { "total_token": 761 }}
返回字段
字段 | 类型 | 说明 |
output.source | string | 实际识别的语种。 |
output.duration_ms | int64 | 音频总时长（毫秒）。 |
output.text | string | 全文识别文本（自动拼接所有分句）。 |
output.sentences[] | array | 分句时间戳：{ begin_ms, end_ms, text }。 |
output.subtitle_url | string | 字幕文件下载 URL（SRT 格式）。 |
usage.total_token | int64 | 消耗 token 总数。 |
错误码
支持语言
支持语言
序号 | 语种（源语言） | Code |
1 | 南非荷兰语（南非） | af-ZA |
2 | 阿尔巴尼亚语（阿尔巴尼亚） | sq-AL |
3 | 阿姆哈拉语（埃塞俄比亚） | am-ET |
4 | 阿拉伯语（阿尔及利亚） | ar-DZ |
5 | 阿拉伯语（巴林） | ar-BH |
6 | 阿拉伯语（埃及） | ar-EG |
7 | 阿拉伯语（伊拉克） | ar-IQ |
8 | 阿拉伯语（以色列） | ar-IL |
9 | 阿拉伯语（约旦） | ar-JO |
10 | 阿拉伯语（科威特） | ar-KW |
11 | 阿拉伯语（黎巴嫩） | ar-LB |
12 | 阿拉伯语（毛里塔尼亚） | ar-MR |
13 | 阿拉伯语（摩洛哥） | ar-MA |
14 | 阿拉伯语（阿曼） | ar-OM |
15 | 阿拉伯语（卡塔尔） | ar-QA |
16 | 阿拉伯语（沙特阿拉伯） | ar-SA |
17 | 阿拉伯语（巴勒斯坦国） | ar-PS |
18 | 阿拉伯语（叙利亚） | ar-SY |
19 | 阿拉伯语（突尼斯） | ar-TN |
20 | 阿拉伯语（阿拉伯联合酋长国） | ar-AE |
21 | 阿拉伯语（也门） | ar-YE |
22 | 亚美尼亚语（亚美尼亚） | hy-AM |
23 | 阿塞拜疆语（阿塞拜疆） | az-AZ |
24 | 巴斯克语（西班牙） | eu-ES |
25 | 孟加拉语（孟加拉） | bn-BD |
26 | 孟加拉语（印度） | bn-IN |
27 | 波斯尼亚语（波斯尼亚和黑塞哥维那） | bs-BA |
28 | 保加利亚语（保加利亚） | bg-BG |
29 | 缅甸语（缅甸） | my-MM |
30 | 加泰罗尼亚语（西班牙） | ca-ES |
31 | 简体中文（中国） | zh-CN |
32 | 中文（中国香港简体） | zh-HK |
33 | 中文（中国台湾繁体） | zh-TW |
34 | 中文粤语（中国香港繁体） | yue |
35 | 克罗地亚语（克罗地亚） | hr-HR |
36 | 捷克语（捷克共和国） | cs-CZ |
37 | 丹麦语（丹麦） | da-DK |
38 | 荷兰语（比利时） | nl-BE |
39 | 荷兰语（荷兰） | nl-NL |
40 | 英语（澳大利亚） | en-AU |
41 | 英语（加拿大） | en-CA |
42 | 英语（加纳） | en-GH |
43 | 英语（中国香港） | en-HK |
44 | 英语（印度） | en-IN |
45 | 英语（爱尔兰） | en-IE |
46 | 英语（肯尼亚） | en-KE |
47 | 英语（新西兰） | en-NZ |
48 | 英语（尼日利亚） | en-NG |
49 | 英语（巴基斯坦） | en-PK |
50 | 英语（菲律宾） | en-PH |
51 | 英语（新加坡） | en-SG |
52 | 英语（南非） | en-ZA |
53 | 英语（坦桑尼亚） | en-TZ |
54 | 英语（英国） | en-GB |
55 | 英语（美国） | en-US |
56 | 爱沙尼亚语（爱沙尼亚） | et-EE |
57 | 菲律宾语（菲律宾） | fil-PH |
58 | 芬兰语（芬兰） | fi-FI |
59 | 法语（比利时） | fr-BE |
60 | 法语（加拿大） | fr-CA |
61 | 法语（法国） | fr-FR |
62 | 法语（瑞士） | fr-CH |
63 | 加利西亚语（西班牙） | gl-ES |
64 | 格鲁吉亚语（格鲁吉亚） | ka-GE |
65 | 德语（奥地利） | de-AT |
66 | 德语（德国） | de-DE |
67 | 德语（瑞士） | de-CH |
68 | 希腊语（希腊） | el-GR |
69 | 古吉拉特语（印度） | gu-IN |
70 | 希伯来语（以色列） | iw-IL |
71 | 印地语（印度） | hi-IN |
72 | 匈牙利语（匈牙利） | hu-HU |
73 | 冰岛语（冰岛） | is-IS |
74 | 印度尼西亚语（印度尼西亚） | id-ID |
75 | 意大利语（意大利） | it-IT |
76 | 意大利语（瑞士） | it-CH |
77 | 日语（日本） | ja-JP |
78 | 爪哇语（印度尼西亚） | jv-ID |
79 | 卡纳达语（印度） | kn-IN |
80 | 哈萨克语（哈萨克斯坦） | kk-KZ |
81 | 高棉语（柬埔寨） | km-KH |
82 | 卢旺达语（卢旺达） | rw-RW |
83 | 韩语（韩国） | ko-KR |
84 | 老挝语（老挝） | lo-LA |
85 | 拉脱维亚语（拉脱维亚） | lv-LV |
86 | 立陶宛语（立陶宛） | lt-LT |
87 | 马其顿语（北马其顿） | mk-MK |
88 | 马来语（马来西亚） | ms-MY |
89 | 马拉雅拉姆语（印度） | ml-IN |
90 | 马拉地语（印度） | mr-IN |
91 | 蒙古语（蒙古） | mn-MN |
92 | 尼泊尔语（尼泊尔） | ne-NP |
93 | 博克马尔挪威语（挪威） | no-NO |
94 | 波斯语（伊朗） | fa-IR |
95 | 波兰语（波兰） | pl-PL |
96 | 葡萄牙语（巴西） | pt-BR |
97 | 葡萄牙语（葡萄牙） | pt-PT |
98 | 旁遮普语（果鲁穆奇语，印度） | pa-Guru-IN |
99 | 罗马尼亚语（罗马尼亚） | ro-RO |
100 | 俄语（俄罗斯） | ru-RU |
101 | 塞尔维亚语（塞尔维亚） | sr-RS |
102 | 僧伽罗语（斯里兰卡） | si-LK |
103 | 斯洛伐克语（斯洛伐克） | sk-SK |
104 | 斯洛文尼亚语（斯洛文尼亚） | sl-SI |
105 | 南索托语（南非） | st-ZA |
106 | 西班牙语（阿根廷） | es-AR |
107 | 西班牙语（玻利维亚） | es-BO |
108 | 西班牙语（智利） | es-CL |
109 | 西班牙语（哥伦比亚） | es-CO |
110 | 西班牙语（哥斯达黎加） | es-CR |
111 | 西班牙语（多米尼加共和国） | es-DO |
112 | 西班牙语（厄瓜多尔） | es-EC |
113 | 西班牙语（萨尔瓦多） | es-SV |
114 | 西班牙语（危地马拉） | es-GT |
115 | 西班牙语（洪都拉斯） | es-HN |
116 | 西班牙语（墨西哥） | es-MX |
117 | 西班牙语（尼加拉瓜） | es-NI |
118 | 西班牙语（巴拿马） | es-PA |
119 | 西班牙语（巴拉圭） | es-PY |
120 | 西班牙语（秘鲁） | es-PE |
121 | 西班牙语（波多黎各） | es-PR |
122 | 西班牙语（西班牙） | es-ES |
123 | 西班牙语（美国） | es-US |
124 | 西班牙语（乌拉圭） | es-UY |
125 | 西班牙语（委内瑞拉） | es-VE |
126 | 巽他语（印度尼西亚） | su-ID |
127 | 斯瓦希里语（肯尼亚） | sw-KE |
128 | 斯瓦希里语（坦桑尼亚） | sw-TZ |
129 | 斯威士语（拉丁字母，南非） | ss-Latn-ZA |
130 | 瑞典语（瑞典） | sv-SE |
131 | 泰米尔语（印度） | ta-IN |
132 | 泰米尔语（马来西亚） | ta-MY |
133 | 泰米尔语（新加坡） | ta-SG |
134 | 泰米尔语（斯里兰卡） | ta-LK |
135 | 泰卢固语（印度） | te-IN |
136 | 泰语（泰国） | th-TH |
137 | 聪加语（南非） | ts-ZA |
138 | 茨瓦纳语（拉丁字母，南非） | tn-Latn-ZA |
139 | 土耳其语（土耳其） | tr-TR |
140 | 乌克兰语（乌克兰） | uk-UA |
141 | 乌尔都语（印度） | ur-IN |
142 | 乌尔都语（巴基斯坦） | ur-PK |
143 | 乌兹别克语（乌兹别克斯坦） | uz-UZ |
144 | 文达语（南非） | ve-ZA |
145 | 越南语（越南） | vi-VN |
146 | 科萨语（南非） | xh-ZA |
147 | 祖鲁语（南非） | zu-ZA |
