# 错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，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"、"APIG"开头的错误码。 当您调用API时，如果遇到"APIGW"开头的错误码，请参见[API网关错误码](https://support.huaweicloud.com/devg-apisign/api-sign-errorcode.html)进行处理。遇到"APIG"开头的错误码，请参考本文档进行处理。 | 模块 | 错误码 | 错误信息 | 说明 | 建议解决方法 | |:---|:---|:---|:---|:---| | 文字识别 | AIS.0101 | The input parameter is invalid. | 输入参数不符合规范。 | 请检查输入参数是否正确。出现此报错可能原因如下： - image、url参数为二选一，请勿同时填写。填写时注意格式规范。 - 功能开关true、false拼写错误。 - 传参时中英文字符错误。 具体参数格式参见各API的请求参数说明。 | | 文字识别 | AIS.0102 | The image format is not supported. | 图片格式不支持，或image参数值不是base64编码字符串。 | 请检查图片格式，各服务支持图片格式请参考[使用限制](https://support.huaweicloud.com/productdesc-ocr/ocr_01_0006.html)。 | | 文字识别 | AIS.0103 | The image size does not meet the requirements. | 图片尺寸不满足要求。 | 请检查图片尺寸，各服务支持图片尺寸请参考[使用限制](https://support.huaweicloud.com/productdesc-ocr/ocr_01_0006.html)。 | | 文字识别 | AIS.0104 | The image is not supported or the image quality is poor. | 非支持的图片类型或图片质量差。 | 请检查图片类型与图片质量。 请检查调用的接口是否正确。 | | 文字识别 | AIS.0105 | Recognition failed. | 算法计算失败。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 文字识别 | AIS.0109 | Service processing timed out. | 服务处理超时。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 文字识别 | AIS.0117 | Input ID does not exist. | 输入ID不存在。 | 请检查入参中的classifier_id或template_id是否存在。 | | 文字识别 | AIS.0118 | Service request error or the tax authority's interface was malfunctioning. | 税局机关接口超时未响应，导致服务请求错误。 | 请等待税局机关接口恢复(建议2小时后重试)。 | | 文字识别 | AIS.0119 | Template match failed, template_id={xxx}. | 输入图片与模板匹配失败。 | 请检查模板中的参照字段是否与输入图片匹配。 | | 文字识别 | AIS.0120 | Classification failed. | 输入图片分类失败。 | 请检查分类器中模板是否与输入图片匹配。 | | 文字识别 | AIS.0121 | The recognition area of template is not configured, template_id={xxx} | 模板未配置识别区。 | 请检查模板是否配置了识别区。 | | 文字识别 | AIS.0122 | The image contains two or more ID cards with the same side. | 存在两张及以上同面身份证。 | 请检查输入图片是否存在两张及以上同面身份证。身份证服务参数side为double_side时，图片中不能存在两张及以上同面身份证。 | | 平台 | 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.4105 | Failed to obtain the temporary AK/SK | 获取用户临时AK，SK失败 | 请联系技术支持人员（如果有使用OBS，请先检查授权）。 | | 平台 | ModelArts.4106 | Invalid authorization request. | 用户账号受限。 | 请检查用户资源状态。账号受限原因请参考[帐号中心相关描述](https://support.huaweicloud.com/account_faq/faq_bi_0011.html)。 | | 平台 | ModelArts.4107 | Get user temp ak sk error. | 获取用户临时AK，SK异常。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | 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. | 请求服务失败，服务未开通。 | - 请前往[文字识别](https://console.huaweicloud.com/ocr/)控制台开通需要调用的API，注意API的开通区域。 - 如已开通服务，请检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致；若一致请检查API的URL是否拼写正确。 | | 平台 | ModelArts.4301 | Have error when get ai-service admin token. | 获取服务admin Token失败。 | 请联系华为云支持人员。 | | 平台 | ModelArts.4302 | Gateway forwarding error. | 访问服务失败。 | 请联系华为云支持人员。 | | 平台 | ModelArts.4401 | Max concurrency error. | 最大并发错误，请求并发过大，超过限额。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4402 | Backend service timeout error. | 服务处理超时。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4403 | Backend service unavailable error. | 服务无法正常响应，或者失败率过高，不可用。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4502 | Backend service response error. | 服务响应失败。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4503 | Backend service found error. | 服务不存在。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4504 | Backend service api not found. | 访问的API不存在。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4505 | Backend service internal error. | 服务内部错误。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4506 | SubService service found error. | 该API对应的子服务不存在。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4508 | Service not start. | 服务不存在或者服务停止。 | 请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 | | 平台 | ModelArts.4601 | Failed to download the file because the file path is not valid, please check it format. | 外网下载地址不合法。 | 请检查输入的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文件不存在。 | 请检查对应的文件是否存在。 | | 平台 | ModelArts.6201 | The user account has been suspended. Please check if you have an outstanding balance. | 用户账户被冻结。 | 请检查账户是否被冻结。请检查账户余额并完成充值。 | | APIG | APIG.0101 | The API does not exist or has not been published in the environment. | 访问的API不存在或尚未在环境中发布。 | - 请检查API的URL是否拼写正确，例如，URL中是否缺少project_id。 - 检查URI中的区域信息是否和调用服务配置的[终端节点](https://support.huaweicloud.com/api-ocr/ocr_03_0062.html)是否对应。 ![](https://support.huaweicloud.com/api-ocr/zh-cn_image_0000001267581097.png "点击放大") - HTTP请求方法（POST，GET等）是否正确。 - 具体的URI信息请在各接口的API页面查看。 | | APIG | APIG.0201 | Backend timeout. | 请求超时。 | - 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。 - 请检查图片是否过大，或网络延时过长，如果图片过大，在保证图片清晰度前提下可以对图片进行等比例压缩；如果网络延时较长，可以适当提升网络传输速度。 | | APIG | APIG.0301 | Incorrect IAM authentication information. | IAM身份验证信息不正确： - decrypt token fail：token解析失败。 - token expires：token过期。 - verify aksk signature fail：AK/SK认证失败。 - x-auth-token not found：未找到x-auth-token参数。 | - token解析失败，请检查获取token的方法，请求体信息是否填写正确，token是否正确；检查获取token的环境与调用的环境是否一致。 - token超时（token expires） ，请重新获取token，使用不过期的token。 - 请检查AK/SK是否正确（AK对应的SK错误，不匹配；AK/SK中多填了空格）。 - AK/SK频繁出现鉴权出错，连续错误5次以上，被锁定5分钟（5分钟内，则一直认为其是异常的鉴权请求），5分钟后解锁重新认证。 - 检查账号权限，是否欠费，被冻结等。 - 检查请求header参数X-Auth-Token是否拼写正确。 | | APIG | APIG.0308 | The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute. | 发送请求超过了服务的默认配置限流。 | 请参考[调用API时提示"APIG.0308"](https://support.huaweicloud.com/ocr_faq/ocr_01_0041.html)方案进行解决。 | | 其他 | 如若出现其他无法解决的错误码，请[联系华为云支持人员](https://www.huaweicloud.com/service/contact.html)。 ||||