错误码
更新时间：2023-05-17
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
例如Access Token失效返回：
{
"error_code": 110,
"error_msg": "Access token invalid or no longer valid"
}需要重新获取新的Access Token再次请求即可。
SDK本地检测参数返回的错误码：
| error_code | error_msg | 备注 |
|---|---|---|
| SDK100 | image size error | 图片大小超限 |
| SDK101 | image length error | 图片边长不符合要求 |
| SDK102 | read image file error | 读取图片文件错误 |
| SDK108 | connection or read data time out | 连接超时或读取数据超时 |
| SDK109 | unsupported image format | 不支持的图片格式 |
服务端返回的错误码
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 1 | Unknown error | 服务器内部错误，请再次请求， 如果持续出现此类错误，请通过QQ群（630770006）或提交工单联系技术支持团队 |
| 2 | Service temporarily unavailable | 服务暂不可用，请再次请求， 如果持续出现此类错误，请通过QQ群（630770006）或提交工单联系技术支持团队 |
| 3 | Unsupported openapi method | 调用的API不存在，请检查请求URL后重新尝试，一般为URL中有非英文字符，如“-”，可手动输入重试 |
| 4 | Open api request limit reached | 集群超限额，请再次请求， 如果持续出现此类错误，请通过QQ群（630770006）或提交工单联系技术支持团队 |
| 6 | No permission to access data | 无权限访问该用户数据，创建应用时未勾选相关接口，请登录百度云控制台，找到对应的应用，编辑应用，勾选上相关接口，然后重试调用 |
| 13 | Get service token failed | 获取token失败 |
| 14 | IAM Certification failed | IAM 鉴权失败，建议参照文档自查鉴权方式是否正确，或换用控制台中ak sk的方式调用 |
| 15 | app not exsits or create failed | 应用不存在或者创建失败 |
| 17 | Open api daily request limit reached | 每天请求量超限额；未上线计费的接口，可通过QQ群（630770006）联系群管、或提交工单申请提额；已上线计费的接口，可直接在控制台开通计费、或购买次数包，调用量不受限制，按调用次数计费，并保证10qps的并发 |
| 18 | Open api qps request limit reached | QPS超限额；未上线计费的接口，可通过QQ群（630770006）联系群管、或提交工单申请提额；已上线计费的接口，可直接在控制台开通计费、或购买次数包，调用量不受限制，按调用次数计费，并保证10qps的并发 |
| 19 | Open api total request limit reached | 请求总量超限额，请通过QQ群（630770006）联系群管、或提交工单申请提额 |
| 100 | Invalid parameter | 无效的access_token参数，token拉取失败，可以参考“Access Token获取”重新获取 |
| 110 | Access token invalid or no longer valid | access_token无效，token有效期为30天，注意需要定期更换，也可以每次请求都拉取新token |
| 111 | Access token expired | access token过期，token有效期为30天，注意需要定期更换，也可以每次请求都拉取新token |
| 282000 | internal error | 服务器内部错误，请再次请求， 如果持续出现此类错误，请通过QQ群（630770006）或提交工单联系技术支持团队。 |
| 216017 | not initialized | 未建库，请先前往百度云控制台，找到对应的应用，在应用详情页 下方申请建库，建库成功后方可正常使用入库、检索、删除、更新接口 |
| 216100 | not find match appid in db | 未建库，请先前往百度云控制台，找到对应的应用，在应用详情页 下方申请建库，建库成功后方可正常使用入库、检索、删除、更新接口 |
| 216101 | not enough param | 缺少必须的参数，请检查参数是否有遗漏，调用接口时会返回具体缺失的参数，如：param image not exist 代表image参数不存在，请检查调用参数 |
| 216102 | service not support | 请求了不支持的服务，请检查调用的url |
| 216103 | param too long | 请求中某些参数过长，请检查后重新尝试 |
| 216110 | appid not exist | appid不存在，请重新核对信息是否为后台应用列表中的appid |
| 216200 | empty image | 图片为空，请检查后重新尝试 |
| 216201 | image format error | 上传的图片格式错误，现阶段支持的图片格式为：PNG、JPG、JPEG、BMP，请进行转码或更换图片 |
| 216202 | image size error | 上传的图片大小错误，现阶段支持的图片大小为：base64编码后小于4M，分辨率不高于4096*4096，请重新上传图片 |
| 216203 | input image cannot handle | 模型提取不到有效的图片特征，一般有以下几种情况：1）图片尺寸太小，比如小于300px，甚至200px；或者图片长宽比太大，比如细长的长条图、竖条图；2）图片特征过于单一，比如纯色图、只有一根黑色的圆柱体等；3）图片中主体太多，比如一张图里有十几双鞋子、或者多只口红啥的，模型不知道应该以哪一个主体为识别目标，就处理不了了。请更换图片 |
| 216630 | recognize error | 识别错误，请再次请求，如果持续出现此类错误，请通过QQ群（630770006）或提交工单联系技术支持团队。 |
| 216401 | internal error | 服务器内部错误，请再次请求，如果持续出现此类错误，请提交工单联系技术支持团队。 |
| 216680 | item not exist | item不在库里 |
| 216681 | item exist | item已经在库里，完全相同的图片不能重复入库 |
| 216634 | detect error | 检测错误，请再次请求，如果持续出现此类错误，请通过QQ群（630770006）或提交工单联系技术支持团队。 |
| 282003 | missing parameters: {参数名} | 请求参数缺失 |
| 282004 | invalid parameter(s) | 请求参数错误。请参考API说明文档，修改参数后重试 |
| 282005 | batch processing error | 处理批量任务时发生部分或全部错误，请根据具体错误码排查 |
| 282006 | batch task limit reached | 批量任务处理数量超出限制，请将任务数量减少到10或10以下 |
| 282111 | url format illegal | 图片url格式非法，建议更换图片地址 |
| 282112 | url download timeout | url下载超时，对应的图床/图片无法下载或链路状况不好，您可以重新尝试一下，如果多次尝试后仍不行，建议更换图片地址 |
| 282113 | url response invalid | URL返回无效参数，一般是图片URL抓图失败，由于图床的差异性，抓图服务无法适配所有的图床，部分URL可能抓不到图，请将图片下载到本地转码后上传 |
| 282114 | url size error | 图片URL长度超过1024字节或为0 |
| 282808 | request id: xxxxx not exist | request id xxxxx 不存在 |
| 282809 | result type error | 返回结果请求错误（不属于excel或json） |
| 282810 | image recognize error | 图像识别错误 |
| 283300 | image recognize error | 数据格式有误，可以检查base64编码、代码格式等 |