一、前提条件
·已 注册腾讯云 账号并开通 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），支持音视频文件转写为文本 |
四、请求示例
cURLcurl -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 总数。 |
八、错误码
请参见 API 错误码说明。
九、支持语言
支持语言
| 序号 | 语种（源语言） | 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 |