高频报错处理办法

本节内容介绍了调用API时，常见的报错及处理办法。

表1 调用API高频报错处理办法
常见报错	处理办法
ModelArts.4204服务未开通	开通该服务，检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，检查API的URL是否拼写正确。
获取Token报错	有三类原因会引起Token报错，需依据返回的具体错误码和错误信息选择解决方案。
图片质量类报错	调用OCR接口时，需使用符合规范的图片。
帐密报错The username or password is wrong	请确认近期华为云帐号是否有升级为华为帐号。如果进行过升级，建议您创建一个IAM帐户，使用该帐户获取Token。

如果在调用API时提示"error_code":"ModelArts.4204"，"error_msg":"Request api error! Have not subscribed this api”，表示未开通对应服务，用户需要开通该服务。具体操作请参考开通服务。

图1 开通服务

如已开通服务，请检查开通服务的区域（或账号）与调用服务的区域（或账号）是否一致，若一致请检查API的URL是否拼写正确。

图2 检查区域信息

获取Token时，请依据报错信息，选择相应的解决方案。

返回"error_code": "APIGW.0101"
请检查获取Token使用的url是否正确。以获取华北-北京四区域的token为例，采用post请求，url为：

https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens
帐密类报错
- 请正确填写username和domainname，可登陆“我的凭证”页面获取。
- 帐密填写正确，依然报错。请确认最近是否有将华为云帐号升级为华为帐号。升级后，主账号将不支持获取token，需要创建IAM帐号用于获取Token。详细处理步骤请参见如何处理帐密报错。
无编程访问权限，返回"This user only supports console access, not programmatic access."
子用户没有编程访问权限，需要联系主账户进行权限设置。

图片质量类报错会产生三种错误码，均表示调用OCR接口时使用的图片不符合规范。

AIS.0102：图片格式不支持。

AIS.0103：图片尺寸不满足要求。

AIS.0104：非支持的图片类型或图片质量差。

检查图片格式规范
- 请参考使用限制检查图片的格式、像素是否符合规范。
- 确保图片的base64编码是完整的，无遗漏字符。
- 检查图片质量，图片中文字是否清晰，肉眼可识别。
检查API的功能是否和图片对应
 API的功能和使用的图片不匹配会报AIS.0104错误（The image is not supported）。例如，使用身份证识别接口，但传入的图片为表格。

获取Token时出现“The username or password is wrong.”。

请确认近期华为云帐号是否有升级为华为帐号。当前，如果您通过华为帐号入口登录华为云帐号，就会指引升级。

华为云帐号若已升级为华为帐号，将不支持获取帐号Token。建议您创建一个IAM帐户，使用该帐户获取Token。

详细处理步骤请参见如何处理帐密报错。

相关文档