录音文件识别回调说明

最近更新时间:2023-08-08 14:57:30

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 机构认证。