错误码汇总
HTTP识别错误码说明
若请求错误,服务器将返回的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采样率)。 |
3303 |
服务端问题 |
语音服务器后端问题 |
请将api返回结果反馈至论坛或者QQ群 |
3304 |
用户请求超限 |
用户的请求并发超限 |
请降低识别并发请求频率 (并发以appId计算,移动端如果共用则累计) |
3305 |
用户请求超限 |
用户的日pv(日请求量)超限 |
请“申请提高配额”,如果暂未通过,请降低日请求量 |
3307 |
服务端问题 |
语音服务器后端识别出错问题 |
目前请确保16000的采样率音频时长低于30s。如果仍有问题,请将api返回结果反馈至论坛或者QQ群 |
3308 |
用户输入错误 |
音频过长 |
音频时长不超过60s,请将音频时长截取为60s以下 |
3309 |
用户输入错误 |
音频数据问题 |
服务端无法将音频转为pcm格式,可能是长度问题,音频格式问题等。 请将输入的音频时长截取为60s以下,并核对下音频的编码,是否是16K或8k, 16bits,单声道。 |
3310 |
用户输入错误 |
输入的音频文件过大 |
语音文件共有3种输入方式: json 里的speech 参数(base64后); 直接post 二进制数据,及callback参数里url。 分别对应三种情况:json超过10M;直接post的语音文件超过10M;callback里回调url的音频文件超过10M |
3311 |
用户输入错误 |
采样率rate参数不在选项里 |
目前rate参数支持16000、8000,填写4000即会有此错误 |
3312 |
用户输入错误 |
音频格式format参数不在选项里 |
目前格式仅仅支持pcm,wav或amr,如填写mp3即会有此错误 |
Android识别错误码说明
错误码分为两类错误,错误领域和错误码,其中错误领域的值可以用于交互,错误码仅用于调试,可能会有修改。
错误码仅提示错误,缩小排查的范围, 不能确认具体出错原因。开发时请对照集成指南文档及demo。
错误领域 |
描述 |
错误码 |
错误描述及可能原因 |
1 |
网络超时 |
|
出现原因可能为网络已经连接但质量比较差,建议检测网络状态 |
|
|
1000 |
DNS连接超时 |
|
|
1001 |
网络连接超时 |
|
|
1002 |
网络读取超时 |
|
|
1003 |
上行网络连接超时 |
|
|
1004 |
上行网络读取超时 |
|
|
1005 |
下行网络连接超时 |
|
|
1006 |
下行网络读取超时 |
2 |
网络连接失败 |
|
出现原因可能是网络权限被禁用,或网络确实未连接,需要开启网络或检测无法联网的原因 |
|
|
2000 |
网络连接失败 |
|
|
2001 |
网络读取失败 |
|
|
2002 |
上行网络连接失败 |
|
|
2003 |
上行网络读取失败 |
|
|
2004 |
下行网络连接失败 |
|
|
2005 |
下行网络读取失败 |
|
|
2006 |
下行数据异常 |
|
|
2100 |
本地网络不可用 |
3 |
音频错误 |
|
出现原因可能为:未声明录音权限,或 被安全软件限制,或 录音设备被占用,需要开发者检测权限声明。 |
|
|
3001 |
录音机打开失败 |
|
|
3002 |
录音机参数错误 |
|
|
3003 |
录音机不可用 |
|
|
3006 |
录音机读取失败 |
|
|
3007 |
录音机关闭失败 |
|
|
3008 |
文件打开失败 |
|
|
3009 |
文件读取失败 |
|
|
3010 |
文件关闭失败 |
|
|
3100 |
VAD异常,通常是VAD资源设置不正确 |
|
|
3101 |
长时间未检测到人说话,请重新识别 |
|
|
3102 |
检测到人说话,但语音过短 |
4 |
协议错误 |
|
出现原因可能是appid和appkey的鉴权失败 |
|
|
4001 |
协议出错 |
|
|
4002 |
协议出错 |
|
|
4003 |
识别出错 |
|
|
4004 |
鉴权错误 ,一般情况是pid appkey secretkey不正确权限 。见下表”4004"鉴权子错误码 |
5 |
客户端调用错误 |
|
一般是开发阶段的调用错误,需要开发者检测调用逻辑或对照文档和demo进行修复。 |
|
|
5001 |
无法加载so库 |
|
|
5002 |
识别参数有误 |
|
|
5003 |
获取token失败 |
|
|
5004 |
客户端DNS解析失败 |
|
|
5005 |
|
6 |
超时 |
|
语音过长,请配合语音识别的使用场景,如避开嘈杂的环境等 |
|
|
6001 |
未开启长语音时,当输入语音超过60s时,会报此错误 |
7 |
没有识别结果 |
|
信噪比差,请配合语音识别的使用场景,如避开嘈杂的环境等 |
|
|
7001 |
没有匹配的识别结果。当检测到语音结束,或手动结束时,服务端收到的音频数据质量有问题,导致没有识别结果 |
8 |
引擎忙 |
|
一般是开发阶段的调用错误,出现原因是上一个会话尚未结束,就让SDK开始下一次识别。SDK目前只支持单任务运行,即便创建多个实例,也只能有一个实例处于工作状态 |
|
|
8001 |
识别引擎繁忙 。当识别正在进行时,再次启动识别,会报busy。 |
9 |
缺少权限 |
|
参见demo中的权限设置 |
|
|
9001 |
没有录音权限 通常是没有配置录音权限:android.permission.RECORD_AUDIO |
10 |
其它错误 |
|
出现原因如:使用离线识别但未将EASR.so集成到程序中;离线授权的参数填写不正确;参数设置错误等。 |
|
|
10001 |
离线引擎异常 |
|
|
10002 |
没有授权文件 |
|
|
10003 |
授权文件不可用 |
|
|
10004 |
离线参数设置错误 |
|
|
10005 |
引擎没有被初始化 |
|
|
10006 |
模型文件不可用 |
|
|
10007 |
语法文件不可用 |
|
|
10008 |
引擎重置失败 |
|
|
10009 |
引擎初始化失败 |
|
|
10010 |
引擎释放失败 |
|
|
10011 |
引擎不支持 |
|
|
10012 |
离线引擎识别失败 。离线识别引擎只能识别grammar文件中约定好的固定的话术,即使支持的话术,识别率也不如在线。请确保说的话清晰,是grammar中文件定义的,测试成功一次后,可以保存录音,便于测试。 |
"4004"鉴权子错误码
4004的子错误值 错误码描述 |
原因 |
|
4 |
pv超限 |
配额使用完毕,请购买或者申请 |
6 |
没勾权限 |
应用不存或者应用没有语音识别的权限 |
13 |
并发超限 |
并发超过限额,请购买或者申请 |
101 |
API key错误 |
API Key 填错 |
唤醒错误码
错误领域 |
描述 |
错误码 |
错误描述 |
10 |
录音设备出错 |
|
|
|
|
1 |
录音设备异常 |
|
|
2 |
无录音权限 |
|
|
3 |
录音设备不可用 |
|
|
4 |
录音中断 |
11 |
唤醒相关错误 |
|
|
|
没有授权文件 |
11002 |
|
|
授权文件不可用 |
11003 |
|
|
唤醒异常, 通常是唤醒词异常 |
11004 |
|
|
模型文件不可用 |
11005 |
|
|
引擎初始化失败 |
11006 |
|
|
内存分配失败 |
11007 |
|
|
引擎重置失败 |
11008 |
|
|
引擎释放失败 |
11009 |
|
|
引擎不支持该架构 |
11010 |
|
38 |
引擎出错 |
|
|
|
|
1 |
唤醒引擎异常 |
|
|
2 |
无授权文件 |
|
|
3 |
授权文件异常 |
|
|
4 |
唤醒异常 |
|
|
5 |
模型文件异常 |
|
|
6 |
引擎初始化失败 |
|
|
7 |
内存分配失败 |
|
|
8 |
引擎重置失败 |
|
|
9 |
引擎释放失败 |
|
|
10 |
引擎不支持该架构 |
|
|
11 |
无识别数据 |
UNIT错误码
点击查看
ios识别错误码说明
识别过程中服务器返回错误状态:
错误码 |
说明 |
-3001 |
协议参数错误 |
-3002 |
识别过程出错 |
-3003 |
没有找到匹配结果 |
-3004 |
PID设置错误 |
-3005 |
声音质量不符合要求 |
-3006 |
语音录入过长,请勿超过60s |
离线引擎错误状态:
错误码 |
说明 |
2228230 |
dat模型文件不可用,请设置 BDS_ASR_OFFLINE_ENGINE_DAT_FILE_PATH |
2228231 |
grammar文件无效 ,请设置 BDS_ASR_OFFLINE_ENGINE_GRAMMER_FILE_PATH |
2228236 |
识别失败,无法识别。(语法模式下,可能为语音不在自定义的语法规则之下) |
2228226 |
[KWS] no license. 首次使用离线引擎请联网,并配置正确的app_id BDS_ASR_OFFLINE_APP_CODE, 绑定BundleId |
2225219 |
server speech quality problem。音频质量过低,无法识别。 |
录音设备错误状态
错误码 |
说明 |
655361 |
录音设备异常 |
655362 |
无录音权限 |
655363 |
录音设备不可用 |
655364 |
录音中断 |
网络错误状态
错误码 |
说明 |
1966081 |
网络意外出错 |
1966082 |
网络不可用 |
2031617 |
网络请求超时 |
2225213 |
日志中有字样 err_no is: -3011. Server unknown error. 一般是网络有代理导致。联网请不要走代理。 |
Linux识别错误码说明
注意把日志开启(EVRDebugLogLevelTrace级别)
EVRClientErrorCodeServerSpeechQualityProblem错误会被sdk吞掉,: 音频质量有问题。因为即使后端检测到音频质量问题,识别仍可继续,所以用户回调中看不到,只能在日志中能看到。
语音识别错误会被分类,具体见TVoiceRecognitionClientErrorDomain的定义。
加粗为用户侧发生的常见错误
DOMAIN |
CODE |
值 |
主要来源 |
描述 |
EVRClientErrorDomainRecord |
|
10 |
SDK |
未知错误 |
EVRClientErrorDomainVAD |
|
20 |
SDK |
语音数据处理VAD过程出错 |
|
EVRClientErrorCodeVADException |
1 |
SDK |
前端库VAD异常 |
|
EVRClientErrorCodeNoSpeech |
2 |
用户音频流 |
用户未说话 |
|
EVRClientErrorCodeShort |
3 |
用户音频流 |
用户说话声音太短 |
EVRClientErrorDomainOnline |
|
30 |
用户/服务端 |
在线识别引擎出错 |
|
EVRClientErrorCodeOnlineExceptioin |
1 |
用户/服务端 |
在线识别引擎异常 |
|
EVRClientErrorCodeOnlineNetworkUnavailable |
2 |
用户音频流 |
网络不可用 |
|
EVRClientErrorCodeOnlineTokenFailed |
3 |
用户 |
获取token失败 ,请检测appId appKey appSecret是否填写正确 |
|
EVRClientErrorCodeOnlineResolveUrlFailed |
4 |
用户 |
解析url失败,请检测网络状态 |
EVRClientErrorDomainLocalNetwork |
|
31 |
用户 |
连接百度服务端的网络问题,先确认联网是否正常 |
|
EVRClientErrorCodeLocalTimeout |
1 |
用户 |
请检测网络状态,请求百度服务器连接超时 |
EVRClientErrorDomainHTTP |
|
32 |
用户/服务端 |
HTTP协议错误。或日志中出现http status不等于200而出错,这与通常的http访问一样,先检查网络状况,如果网络状况正常,可反馈 |
EVRClientErrorDomainServer |
|
33 |
用户/服务端 |
服务器返回错误 。或日志中出现-300X,均是后端返回的错误,除了-3005外可尝试重试。 |
|
EVRClientErrorDomainServer |
-3001 |
服务端 |
后端从SDK读数据失败,可能是sdk检测到后端超时,断开了连接,重试 |
|
EVRClientErrorCodeServerRecognError |
-3002 |
服务端 |
识别过程出错 |
|
EVRClientErrorCodeServerNoFindResult |
-3003 |
服务端 |
协议参数错误 |
|
EVRClientErrorCodeServerAppNameUnknownError |
-3004 |
用户 |
appId appKey appSecret填写错误 或流量超过限制 |
|
EVRClientErrorCodeServerSpeechQualityProblem |
-3005 |
用户 |
声音不符合识别要求,通常是语音质量问题或采样率设的不对 。如果确认那块(报错的句子所处的音频位置段)音频没问题,可再检查采样率和别的识别参数有误问题。 音频质量问题,自查对应位置的音频,通常忽略该问题 |
|
EVRClientErrorCodeServerSpeechTooLong |
-3006 |
用户 |
语音过长,确认是否开启了本地vad,以及vad门限是否过大 |
|
|
-3007 |
SDK/服务端 |
后端检测到sdk传递的数据类型不对,通常不会出现,出现则重试 |
|
EVRClientErrorCodeServerSpeechParamsUnknow |
-3008 |
服务端 |
上行参数未知,(可能是gzip解压失败) 后端检测到sdk传递的json参数不对,通常不会出现,出现则重试 |
|
EVRClientErrorCodeServerSpeechNoUploadLink |
-3011 |
用户网络 |
上行流建立失败,可能跟网络状况或后端有关,重试 |
|
|
-3012 |
用户网络 |
下行流建立失败,可能跟网络状况或后端有关,重试 |
|
|
-3013 |
服务端 |
后端错误 |
|
|
-3014 |
用户 |
用户自己取消,忽略之 |
EVRClientErrorDomainOffline |
|
34 |
服务端 |
未知错误 |
|
EVRClientErrorCodeRecoderException |
1 |
SDK |
未知错误 |
|
EVRClientErrorCodeRecoderNoPermission |
2 |
SDK |
未知错误 |
|
EVRClientErrorCodeRecoderUnAvailable |
3 |
SDK |
未知错误 |
|
EVRClientErrorCodeInterruption |
4 |
SDK |
未知错误 |
EVRClientErrorDomainCommon |
|
40 |
|
其它错误 |
|
EVRClientErrorCodeServerSpeechNoUploadLink |
4095 |
SDK |
识别器忙 |
|
EVRClientErrorCodeCommonPropertyListInvalid |
2 |
用户 |
垂类设置有误 |
|
EVRClientErrorCodeCommonEnqueueError |
3 |
用户 |
语音数据enqueue失败 |
![]()