错误码
调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系技术支持，并提供错误码，以便尽快帮您解决问题。
错误响应Body体格式说明
当接口调用出错时，会返回错误码及错误信息说明，错误响应的Body体格式如下所示。
{
"error_msg": "The input parameter is invalid.",
"error_code": "AIS.0101"
} 其中，error_code表示错误码，error_msg表示错误描述信息。
错误码说明
由于OCR服务部署在ModelArts平台，使用API网关（API Gateway）系统，因此OCR服务错误码会出现“ModelArts”、“APIGW”、“APIG”开头的错误码。
当您调用API时，如果遇到“APIGW”开头的错误码，请参见进行处理。遇到“APIG”开头的错误码，请参考本文档进行处理。
| 模块 | 错误码 | 错误信息 | 说明 | 建议解决方法 |
|---|---|---|---|---|
| 文字识别 | AIS.0101 | The input parameter is invalid. | 输入参数不符合规范。 | 请检查输入参数。各服务具体输入参数格式参见API参考>API>请求参数说明。 |
| AIS.0102 | The image format is not supported. | 图片格式不支持。 | 请检查图片格式。 | |
| AIS.0103 | The image size does not meet the requirements. | 图片尺寸不满足要求。 | 请检查图片尺寸。 | |
| AIS.0104 | The image is not supported or the image quality is poor. | 非支持的图片类型或图片质量差。 | 请检查图片类型与图片质量。 请检查调用的接口是否正确。 | |
| AIS.0105 | Recognition failed. | 算法计算失败。 | 请联系技术支持。 | |
| 平台 | ModelArts.0203 | Invalid token. | 非法Token。 | 请检查Token是否正确。 |
| ModelArts.4101 | Token header cannot be empty. | Token为空。 | 发送的HTTP请求header中没有带x-auth-token的token请求认证信息，请检查发送的请求。 | |
| ModelArts.4102 | Parse Token error. | 解析Token失败。 | 发送的HTTP请求header中x-auth-token的token请求认证信息错误，请检查发送的请求和token。 | |
| ModelArts.4103 | Invalid Token header. | Token不合法。 | 发送的HTTP请求header中x-auth-token的token请求认证信息错误，请检查发送的请求和token。 | |
| ModelArts.4104 | Invalid Request Content Length. | 请求body体长度不合法。 | 请检查请求body体长度。要求Base64编码后大小不超过10MB。 | |
| ModelArts.4105 | The JSON format of the input data is incorrect. | 请求body体JSON格式不对。 | 请检查请求body体是否符合JSON格式。 | |
| ModelArts.4106 | Invalid authorization request. | 用户账号受限。 | 请检查用户资源状态。 | |
| ModelArts.4107 | Get user temp ak sk error. | 获取用户临时AK，SK异常。 | 请联系技术支持。 | |
| ModelArts.4201 | Request url need service id. | 请求url中需要包含服务ID。 | 请检查请求url中的服务ID。 | |
| ModelArts.4202 | Request url format invalid. | 请求url格式不合法。 | 请检查请求url格式。 | |
| ModelArts.4203 | Access denied! You do not have permission. | 没有权限访问。 | 请检查访问权限。 | |
| ModelArts.4204 | Request api error! The API XXX is not subscribed. | 请求服务失败，服务未开通。 |
| |
| ModelArts.4301 | Have error when get ai-service admin token. | 获取服务admin Token失败。 | 请联系技术支持。 | |
| ModelArts.4302 | Gateway forwarding error. | 访问服务失败。 | 请联系技术支持。 | |
| ModelArts.4401 | Max concurrency error. | 最大并发错误，请求并发过大，超过限额。 | 请联系技术支持。 | |
| ModelArts.4402 | Backend service timeout error. | 服务处理超时。 | 请联系技术支持。 | |
| ModelArts.4403 | Backend service unavailable error. | 服务无法正常响应，或者失败率过高，不可用。 | 请联系技术支持。 | |
| ModelArts.4502 | Backend service response error. | 服务响应失败。 | 请联系技术支持。 | |
| ModelArts.4503 | Backend service found error. | 服务不存在。 | 请联系技术支持。 | |
| ModelArts.4504 | Backend service api not found. | 访问的API不存在。 | 请联系技术支持。 | |
| ModelArts.4505 | Backend service internal error. | 服务内部错误。 | 请联系技术支持。 | |
| ModelArts.4506 | SubService service found error. | 该API对应的子服务不存在。 | 请联系技术支持。 | |
| ModelArts.4508 | Service not start. | 服务不存在或者服务停止。 | 请联系技术支持。 | |
| ModelArts.4601 | The URL is not allowed. | 外网下载地址不合法。 | 请检查输入的url下载地址参数格式。 | |
| ModelArts.4603 | Obtaining the file from the URL failed. | 下载外网URL文件失败。 | 请检查网络与URL。 | |
| ModelArts.4702 | Query Obs agency failed. | 查询OBS委托失败。 | 请检查是否已开通服务的OBS委托。 | |
| ModelArts.4703 | The Obs URL is invalid. | OBS地址不合法。 | 请检查OBS地址。 | |
| ModelArts.4704 | Obtaining the file from the OBS failed. | 获取OBS文件失败。 | 请检查OBS文件。 | |
| ModelArts.4705 | The file stored on the OBS is oversized. | OBS文件大小超限。 | 请检查OBS文件大小，请使用符合服务大小限制的文件作为输入。 | |
| ModelArts.4706 | The Obs file is not exist. | OBS文件不存在。 | 请检查对应的文件是否存在。 | |
| APIG | APIG.0101 | The API does not exist or has not been published in the environment. | 访问的API不存在或尚未在环境中发布。 |
|
| APIG.0201 | Backend timeout. | 请求超时。 | 请联系技术支持。 | |
| APIG.0301 | Incorrect IAM authentication information. | IAM身份验证信息不正确：
|
| |
| APIG.0308 | The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute. | 发送请求超过了服务的默认配置限流。 | 请联系技术支持。 |
