错误码汇总
更新时间：2024-04-02
短语音识别错误码
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 4 | Open api request limit reached | 集群超限额 |
| 6 | No permission to access data | 对控制台内app进行编辑，添加语音权限 |
| 14 | IAM Certification failed | IAM鉴权失败，建议用户参照文档自查生成sign的方式是否正确，或换用控制台中ak sk的方式调用 |
| 17 | Open api daily request limit reached | 每天流量超限额 |
| 18 | Open api qps request limit reached | 并发超限额 |
| 19 | Open api total request limit reached | 请求总量超限额 |
| 100 | Invalid parameter | 无效参数 |
| 110 | Access token invalid or no longer valid | Access Token失效 |
| 111 | Access token expired | Access token过期 |
| 错误码 | 用户输入 / 服务端 | 含义 | 一般解决方法 |
|---|---|---|---|
| 3300 | 用户输入错误 | 输入参数不正确 | 请仔细核对文档及参照 demo，核对输入参数 |
| 3301 | 用户输入错误 | 音频质量过差 | 请上传清晰的音频 |
| 3302 | 用户输入错误 | 鉴权失败 | token字段校验失败。请使用正确的API_KEY 和 SECRET_KEY生成。 或并发、调用量超出限额。 或音频采样率不正确（可尝试更换为16k采样率）。 或者自训练平台 lm_id 不属于该账号 |
| 3303 | 服务端问题 | 百度服务器后端繁忙 | 有可能是原始音频质量过差。可以请将 api 返回结果和原始音频反馈至论坛或者 QQ 群 |
| 3304 | 用户请求超限 | 用户的请求并发超限 | 请降低识别 api 请求频率 （并发以 appId 计算，移动端如果共用则累计） |
| 3305 | 用户请求超限 | 用户的日 pv（日请求量）超限 | 请开通付费，购买调用量资源（账号内所有应用 APPID 共用调用量限额） |
| 3307 | 服务端问题 | 语音服务器后端识别出错问题 | 有可能是原始音频质量过差。可以将 api 返回结果和原始音频反馈至工单、论坛或者 QQ 群 |
| 3308 | 用户输入错误 | 音频过长 | 音频时长不超过 60s，请将音频时长截取为 60s 以下，特别是 amr 格式 |
| 3309 | 用户输入错误 | 音频数据问题 | 服务端无法将音频转为 pcm 格式，可能是长度问题，音频格式问题等。 请将输入的音频时长截取为 60s 以下，并核对下音频的编码，采样率 16000，单声道，小端序，16bits。 |
| 3310 | 用户输入错误 | 输入的音频文件过大 或 len 参数过大 | 文件内容过大，音频时长不能超过 60s |
| 3311 | 用户输入错误 | 采样率 rate 参数不在选项里 | 目前 rate 参数支持 16000、8000，填写其他值即会有此错误。 |
| 3312 | 用户输入错误 | 音频格式 format 参数不在选项里 | 目前格式仅仅支持 pcm，wav 或 amr，如填写 mp3 即会有此错误 |
| 3313 | 服务端问题 | 语音服务器解析超时 | 请将 api 返回结果反馈至工单、论坛或者 QQ 群 |
| 3314 | 用户输入错误 | 音频长度过短 | 用户的 len 参数小于等于 4 |
| 3315 | 服务端问题 | 语音服务器处理超时 | 请将 api 返回结果反馈至工单、论坛或者 QQ 群 |
| 3316 | 用户输入错误 | 音频转为 pcm 失败 | 使用 pcm 格式，或者确认 wav 和 amr 的采样率 16000，单声道。 wav 是否是 pcm 编码，小端序，16bits |
实时语音识别错误码
报错示例：
{
"err_msg": "asr authentication failed",
"err_no": -3004,
"log_id": 106549729,
"result": "",
"sn": "0d25b5e1-ffa6-11e9-8968-f496349f3917",
"type": "FIN_TEXT"
}err_no = 0 是正确，非0值即为报错。 在err_msg中一般有更具体的报错信息。
| 错误码err_no | 错误方 | 原因 | 解决方法 | 是否会识别并关闭连接 |
|---|---|---|---|---|
| -3001 | 百度服务端问题 | 后端从SDK读数据失败，可能是sdk检测到后端超时，断开了连接 | 重试 | 是 |
| -3003 | 百度服务端问题 | 服务后端异常 | 记录报错json并反馈 | 这一句话报错，不影响后续识别 |
| -3004 | 调用方问题 | 鉴权失败，没有权限调用接口 | 查看appid appkey devpid这3个参数有无填对，QPS有无超限 | 是 |
| -3005 | 调用方问题 | 音频质量问题，无效音频 | 根据start_time和end_time可以听下是否是噪音 | 这一句话报错，不影响后续识别 |
| -3006 | 百度服务端问题 | 服务后端VAD异常 | 记录报错json并反馈 | 是 |
| -3008 | 调用方问题 | 开始参数帧参数错误，包括漏写 | 检测参数有无缺失及格式正确，在err_msg中有更具体的报错信息 | 是 |
| -3011 | 用户网络问题 | 上行流建立失败，可能跟网络状况或后端有关 | 重试 | 是 |
| -3012 | 用户网络问题 | 下行流建立失败，可能跟网络状况或后端有关 | 重试 | 是 |
| -3013 | 百度服务端问题 | 服务后端异常 | 记录报错json并反馈 | 这一句话报错，不影响后续识别 |
| -3014 | 调用方正常调用CANCEL | 用户取消 | 如果发送取消帧后会有此返回，可以忽略 | 是 |
| -3101 | 调用方问题 | 一段时间没发出音频数据，导致整体请求超时 | 确认代码有音频数据一直在发送中 | 是 |
音频文件转写任务状态及错误码
任务状态 task_status
| 取值 | 对应状态 |
|---|---|
| Running | 转写中 |
| Success | 转写成功 |
| Failure | 转写失败 |
接口错误码
| error_code | error_msg | 对应接口 | 描述 |
|---|---|---|---|
| 336200 | internal error | 1，2 | 内部错误，注意task_id类型非字符串 |
| 336201 | unknown task id | 2 | 未知task id |
| 336202 | invalid param: task_ids | 1，2 | 无效参数值 |
| 336203 | missing param: ‘param_name’ | 1，2 | 缺少必要参数 |
| 336204 | Open api total request limit reached’ | 1，2 | 请开通付费，购买调用时长资源 |
| 336212 | invalid json | 1，2 | 请求数据为非法json |
| 336213 | missing header: 'header_name' | 1，2 | 缺少必要header |
音频转写结果错误码
| err_no | err_msg | 描述 |
|---|---|---|
| 3301 | speech quality error. | 音频文件格式不对 |
| 4001 | open speech file failed | 打开音频文件失败 |
| 4002 | speech length too short | 音频文件长度太短 |
| 4003 | internal error | 内部错误 |
| 4004 | internal error | 内部错误 |
| 4005 | internal error | 内部错误 |
| 4006 | internal error | 内部错误 |
| 4007 | internal error | 内部错误 |
| 4008 | invalid input | 无效语音 |
| 4009 | speech length too short | 音频文件长度太短 |
| 4010 | invalid input | 无效语音 |
| 4011 | internal error | 内部错误 |
| 4012 | internal error | 内部错误 |
| 4013 | internal error | 内部错误 |
| 4014 | internal error | 内部错误 |
| 4015 | internal error | 内部错误 |
| 4016 | not support speech format | 音频格式错误，不是pcm或者wav |
| 4017 | not support rate | 采样率错误，非16000或8000 |
| 4018 | read speech file failed | 读音频文件失败 |
| 4019 | internal error | 内部错误 |
| 4020 | internal error | 内部错误 |
| 4041 | invalid input | 无效语音 |
| 100000 | asr task internal error | 任务内部错误 |
| 100001 | asr task running timeout | 任务运行超时 |
| 100101 | illegal speech url format | url格式非法 |
| 100102 | request timeout to speech url | http请求超时 |
| 100103 | request error to speech url | http请求错误，检查音频url链接，如没有问题请反馈工单排查 |
| 100104 | invalid response from speech url | 返回无效数据，http status 非200，回包body为空等 |
| 100105 | invalid speech size | 回包大小超限，音频最大100MB |
| 100201 | not support speech format | 不支持音频格式 |
| 100202 | speech transcoding failed | 文件转码失败 |
| 100203 | not support pid | 不支持的pid |
| 100204 | not support rate | 不支持的rate |
| 100205 | audio file is faulty | 无法解析格式的音频 |
| 100206 | Not support vad | VAD大小超限不支持 |
| 100207 | Not support channel | 通道数超限不支持 |
| 100010 | asr task internal error | 内部错误 |
| 100020 | Authentication and Rate Limit Failed | 鉴权或流控失败 |
| 100022 | An http exception occurred during Authentication and Rate Limitation | 鉴权或流控过程中HTTP出错 |
| 200100 | Invalid parameter | 参数错误 |
| 200108 | Invalid user id | 用户id参数错误 |
| 200115 | Invalid AppID or no permission | AppID参数错误 |
问题反馈
如有使用问题，可通过提交工单进行反馈。