大模型服务平台 TokenHub Hy 异步语音识别

一、前提条件

·已注册腾讯云账号并开通 TokenHub 服务。

·已在 TokenHub 控制台获取 API Key。

二、接口信息

项	值
地址	https://tokenhub.tencentmaas.com/v1/wand/asrproxy/async_create
方法	POST
Content-Type	application/json
鉴权	Authorization: Bearer YOUR_API_KEY

三、支持模型

模型名称	model（调用参数）	能力说明
Hy-ASR-3.0-Preview	hy-asr-3.0-preview	中文普通话+英语＋多方言混合引擎，除中英外，支持多种方言，包括粤语、东北话、河南话、陕西话、成都话、重庆话、武汉话、贵阳话、青岛话、济南话、长沙话、合肥话等。

四、请求示例

cURLcurl -X POST 'https://tokenhub.tencentmaas.com/v1/wand/asrproxy/async_create' \\ -H 'Authorization: Bearer YOUR_API_KEY' \\ -H "Content-Type: application/json" \\ -d '{ "model": "hy-asr-3.0-preview", "input_url": "https://cos.example.com/xxx.mp4" }'

五、请求参数

参数	类型	必选	说明
model	string	是	模型名称，固定为 hy-asr-3.0-preview。
input_url	string	是	待识别的音视频文件地址（支持常见音视频格式）。最大支持音频/视频时长 <= 10小时，文件大小 <= 10GB，处理速度 2～3 倍速；需要公网可访问（http/https）。
source	string	否	识别语种；缺省时后端自动检测。
subtitle_format	string	否	字幕格式：srt / vtt；缺省 srt。

六、返回示例

注意：说明：

注意：接口为异步提交，返回任务标识，不立即返回识别结果。

{ "id": "th_251416641_700001910665_asrproxy_781c68c15207f3a7fc6c7ca48512b964", "created_at": 1721808000, "status": "queued", "request_id": "64094fda-c5ae-4e32-97cf-1cf71ff2ae09"}

七、返回字段

字段	类型	说明
id	string	任务标识，用于后续查询任务结果。
status	string	任务状态：queued / in_progress / completed / failed。

八、接口信息

项	值
地址	https://tokenhub.tencentmaas.com/v1/wand/asrproxy/tasks/{id}
方法	GET
Content-Type	application/json
鉴权	Authorization: Bearer YOUR_API_KEY

九、请求示例

cURLcurl -X GET 'https://tokenhub.tencentmaas.com/v1/wand/asrproxy/tasks/YOUR_TASK_ID' \\ -H 'Authorization: Bearer YOUR_API_KEY'

十、响应字段

字段	类型	说明
request_id	string	请求标识。
id	string	任务标识。
object	string	对象类型，固定 asr.task。
created_at	int	创建时间戳（Unix 秒）。
status	string	任务状态：queued / in_progress / completed / failed。
output.source	string	实际识别的语种。
output.duration_ms	int64	音频总时长（毫秒）。
output.text	string	全文识别文本。
output.sentences[]	array	分句时间戳：{ begin_ms, end_ms, text }。
output.subtitle_url	string	字幕文件下载 URL。
usage.total_token	int64	消耗 token 总数。
error	object	错误信息，仅 failed 时存在。

十一、返回示例

{ "id": "th_251416641_700001910665_asrproxy_781c68c15207f3a7fc6c7ca48512b964", "object": "asr.task", "created_at": 1721808000, "status": "completed", "request_id": "b1504f51-0d47-4662-8389-c76b9b0db54e", "output": { "subtitle_url": "https://xxx.cos.ap-guangzhou.myqcloud.com/subtitle/xxx.srt" }, "usage": { "total_token": 6025 }}

十二、错误码

请参见 API 错误码说明。