文档首页/文字识别 OCR/API参考/错误码
更新时间：2025-04-23 GMT+08:00
查看PDF
分享

错误码

调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，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”开头的错误码，请参见API网关错误码进行处理。遇到“APIG”开头的错误码，请参考本文档进行处理。

模块

错误码

错误信息

说明

建议解决方法

文字识别

AIS.0101

The input parameter is invalid.

输入参数不符合规范。

请检查输入参数是否正确。出现此报错可能原因如下：

  • image、url参数为二选一，请勿同时填写。填写时注意格式规范。
  • 功能开关true、false拼写错误。
  • 传参时中英文字符错误。

具体参数格式参见各API的请求参数说明。

AIS.0102

The image format is not supported.

图片格式不支持，或image参数值不是base64编码字符串。

请检查图片格式，各服务支持图片格式请参考使用限制。

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.

算法计算失败。

请联系华为云支持人员。

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格式。

Failed to obtain the temporary AK/SK

获取用户临时AK，SK失败

请联系技术支持人员（如果有使用OBS，请先检查授权）。

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.

请求服务失败，服务未开通。

  • 请前往文字识别控制台开通需要调用的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.

最大并发错误，请求并发过大，超过限额。

请联系华为云支持人员。

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

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中的区域信息是否和调用服务配置的终端节点是否对应。

  • HTTP请求方法（POST，GET等）是否正确。
  • 具体的URI信息请在各接口的API页面查看。

APIG.0201

Backend timeout.

请求超时。

  • 请检查原调用请求是否过于频繁，如果是并发过大，可以通过重试机制解决，在代码里检查返回值，碰到这个并发错误可以延时一小段时间（如2-5s）重试请求；也可以后端检查上一个请求结果，上一个请求返回之后再发送下一个请求，避免请求过于频繁。
  • 请检查图片是否过大，或网络延时过长，如果图片过大，在保证图片清晰度前提下可以对图片进行等比例压缩；如果网络延时较长，可以适当提升网络传输速度。

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.0308

The throttling threshold has been reached: policy user over ratelimit,limit:XX,time:1 minute.

发送请求超过了服务的默认配置限流。

请参考调用API时提示"APIG.0308"方案进行解决。

其他

如若出现其他无法解决的错误码，请联系华为云支持人员。

相关文档