tencent cloud

APIs

文档APIsAutomatic Speech RecognitionRecording Recognition APIsRecording Recognition Callback Description

录音文件识别回调说明

下载
聚焦模式
字号
最后更新时间： 2026-05-26 11:05:25

1. 回调说明

录音识别请求中，如果用户设置了 CallbackUrl 参数，则通过回调的方式来返回识别结果，用户需要自行搭建可公网访问的 HTTP 或者 HTTPS 服务，并在创建录音识别任务时，将回调 Url 填写到 CallbackUrl 中。回调时，会使用 HTTP 的 POST 方法，将所有内容会放入 Body 中，Content-Type 为 application/x-www-form-urlencoded。

2. 回调 Body 说明

2.1 回调 Body 示例

code=0&requestId=4000048858&appid=12516****&projectid=0&text=%5B0%3A1.640%2C0%3A4.600%5D++%E6%88%91%E5%9C%A8%E9%A9%AC%E4%B8%8A%E4%B8%8A%E5%A4%9C%E7%8F%AD%E3%80%82%0A%5B0%3A5.420%2C0%3A7.820%5D++%E6%98%8E%E5%A4%A9%E6%97%A9%E4%B8%8A%E8%AF%B4%E5%93%88%E3%80%82%0A&audioTime=8.420000&message=&resultDetail=

2.2 回调参数说明

字段
类型
描述
code
int64
任务状态码，0为成功，其他：失败；详见 状态码说明
message
string
失败原因文字描述，成功时此值为空
requestId
uint64
任务唯一标识，与录音识别请求中返回的 TaskId 一致。数据格式必须设置为 Uint64
appid
uint64
腾讯云应用 ID
projectid
int64
腾讯云项目 ID
audioUrl
string
语音 url，如创建任务时为上传数据的方式，则不包含该字段
text
string
识别出的结果文本
resultDetail
string
包含 详细识别结果，如创建任务时 ResTextFormat 为0，则不包含该字段
audioTime
double
语音总时长

3. 回调 Response 说明

用户侧收到回调请求后，需要以 JSON 格式返回响应。

3.1 回调 Response 示例

{ "code" : 0, "message" : "success" }

3.2 回调 Response 参数说明

参数名称
类型
描述
code
int64
错误码，0为成功，其他值代表失败
message
string
失败原因说明

4. 回调状态码

数值
说明
10000
转码失败，请确认音频格式是否符合标准
10001
识别失败
10002
语音时长太短
10003
语音时长太长
10004
无效的语音文件
10005
其他失败
10006
音轨个数不匹配
10007
音频下载失败

5. 常见问题

5.1 回调最多尝试几次？

最多2次。

5.2 过了很久都没有收到回调怎么办？

请确认回调服务正常，且回调地址是否在公网下可访问。
如果回调地址是 https 的，请确认证书经过合法 CA 机构认证。
上一篇: CreateRecTask下一篇: Real-Time Speech Recognition (WebSocket)

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈