一什么水
更新时间：2025-08-05
FAQ
1. 调用接口时抛出异常：基础连接已关闭 此问题一般是网络原因，请检查网络相关问题：
- 检查网络连通性
- 检查网络是否有代理
2. SSL报错 "The authentication or decryption has failed" 可能由于网络代理等原因导致证书不正确，属于常见的http问题，可以参考这个答案 如果报此错，请务必关注HTTPS安全
3. 调用接口，等待一段时间后出现超时 可以设置Timeout参数
4. 在.Net Core下运行报错 'GBK' is not a supported encoding name'
添加System.Text.Encoding.CodePages引用，并注册。 Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)
错误返回格式
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
错误码
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群（659268104）或工单联系技术支持团队。 |
| 2 | Service temporarily unavailable | 服务暂不可用，请再次请求， 如果持续出现此类错误，请通过QQ群（659268104）或工单联系技术支持团队。 |
| 3 | Unsupported openapi method | 调用的API不存在，请检查请求URL后重新尝试，一般为URL中有非英文字符，如“-”，可手动输入重试 |
| 4 | Open api request limit reached | 集群超限额，请再次请求， 如果持续出现此类错误，请通过QQ群（860337848）或提交工单联系技术支持团队。 |
| 6 | No permission to access data | 无权限访问该用户数据，创建应用时未勾选相关接口，请登录百度云控制台，找到对应的应用，编辑应用，勾选上相关接口，然后重试调用 |
| 13 | Get service token failed | 获取token失败 |
| 14 | IAM Certification failed | IAM 鉴权失败，建议参照文档自查生成sign的方式是否正确，或换用控制台中ak sk的方式调用 |
| 15 | app not exsits or create failed | 应用不存在或者创建失败 |
| 17 | Open api daily request limit reached | 每天请求量超限额，已上线计费的接口，请直接在控制台开通计费，调用量不受限制，按调用量阶梯计费；未上线计费的接口，请提交工单、或通过QQ群（659268104）联系群管手动提额 |
| 18 | Open api qps request limit reached | QPS超限额，已上线计费的接口，请直接在控制台开通计费，调用量不受限制，按调用量阶梯计费；未上线计费的接口，请提交工单、或通过QQ群（659268104）联系群管手动提额 |
| 19 | Open api total request limit reached | 请求总量超限额，已上线计费的接口，请直接在控制台开通计费，调用量不受限制，按调用量阶梯计费；未上线计费的接口，请提交工单、或通过QQ群（659268104）联系群管手动提额 |
| 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群（659268104）或提交工单联系技术支持团队。 |
| 216100 | invalid param | 请求中包含非法参数，请检查后重新尝试 |
| 216101 | not enough param | 缺少必须的参数，请检查参数是否有遗漏 |
| 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 | image size error | 上传的图片base64编码有误，请校验base64编码方式，并重新上传图片 |
| 216630 | recognize error | 识别错误，请再次请求，如果持续出现此类错误，请通过QQ群（659268104）或提交工单联系技术支持团队。 |
| 216634 | detect error | 检测错误，请再次请求，如果持续出现此类错误，请通过QQ群（659268104）或提交工单联系技术支持团队。 |
| 282003 | missing parameters: {参数名} | 请求参数缺失 |
| 282005 | batch ?processing error | 处理批量任务时发生部分或全部错误，请根据具体错误码排查 |
| 282006 | batch task ?limit reached | 批量任务处理数量超出限制，请将任务数量减少到10或10以下 |
| 282100 | image transcode error | 图片压缩转码错误 |
| 282101 | image split limit reached | 长图片切分数量超限 |
| 282102 | target detect error | 未检测到图片中识别目标 |
| 282103 | target recognize error | 图片目标识别错误 |
| 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 | Invalid argument | 入参格式有误，可检查下图片编码、代码格式是否有误 |
| 336000 | Internal error | 服务器内部错误，请再次请求， 如果持续出现此类错误，请通过QQ群（659268104）或提交工单联系技术支持团队 |
| 336001 | Invalid Argument | 入参格式有误，比如缺少必要参数、图片base64编码错误等等，可检查下图片编码、代码格式是否有误。有疑问请通过QQ群（659268104）或提交工单联系技术支持团队 |