错误码

更新时间：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编码、代码格式等

私有化部署方案

常见问题