文字识别API常见错误码原因及处理方法-视觉智能开放平台-阿里云

当API请求发生错误时，服务端会返回错误信息。本文为您介绍文字识别API返回的错误码信息。

说明

阿里云视觉智能开放平台各类目视觉AI能力API接入、接口使用或问题咨询等，请通过钉钉群（23109592）加入阿里云视觉智能开放平台咨询群联系我们。

问题诊断中心

使用问题诊断中心可帮助开发者更高效地诊断API使用过程中的问题。

文字识别错误码

状态码	错误码	描述
403	AuthFailed	授权失败，请检查RAM权限配置。
400	ClientError.IllegalArgument	请检查参数，如参数值所代表的数据库是否存在。
400	EntityNotExist.Role	没有RAM权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，具体操作，请参见使用RAM Policy控制访问权限。
400	IllegalUrlParameter	URL不合法，请检查URL能否正常打开，非上海OSS图片链接，请参见文件URL处理。
500	InternalError	服务器内部错误。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Algo	内部算法处理错误。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Timeout	内部处理超时错误。如有影响业务，请通过钉钉群（23109592）联系我们。
400	InvalidAccessKeyId.Inactive	AccessKeyID非法，请检查AccessKeyID是否被禁用，或者AccessKeyID和AccessKeySecret是否填写正确。
404	InvalidAccessKeyId.NotFound	AccessKeyID不存在。请检查调用时是否使用了正确的AccessKey。更多信息，请参见创建AccessKey。
400	InvalidAccessKeySecret	AccessKeyID或AccessKeySecret填写错误，请检查AccessKeyID和AccessKeySecret是否填写正确。
400	InvalidAction.NotFound	能力未找到，请检查类目与能力是否匹配，检查访问域名与能力是否匹配。更多信息，请参见访问域名。选择合适编程语言根据实例代码作相关修改进行接入，具体操作，请参见SDK总览。
400	InvalidApi.ForbiddenInvoke	调用受限，请检查您调用的能力是否为受限能力，受限能力需要在控制台找到相应能力申请，经过审批或者手动激活之后才能调用。如非上述情况，请检查账号是否欠费。
403	InvalidApi.NotPurchase	服务未开通，请先开通服务。
400	InvalidApi.OutOfService	产品未开通，请开通产品。
400	InvalidFile.Content	请参考算法文档检查文件内容，更换包含符合算法要求的文件。
400	InvalidFile.Decode	请检查文件是否能够正常打开。
400	InvalidFile.Download	文件无法下载，请检查本地网络情况，以及链接是否可访问。非上海OSS文件链接，请参见文件URL处理。
400	InvalidFile.REGION	文件链接地域错误，非上海OSS文件链接，请参见文件URL处理。
400	InvalidFile.Resolution	文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试。
400	InvalidFile.Type	文件类型错误，请检查文件类型，参考算法API文档，使用算法支持的文件类型。阿里云视觉智能开放平台能够读取文件并获取真实的文件类型，不是通过文件后缀名进行类型判断，只看文件后缀名是无效的，关于更多文件类型判断和处理信息，请参见文件类型判断和处理。
400	InvalidFile.URL	文件无法下载，请检查本地网络情况，以及链接是否可访问。非上海OSS文件链接，请参见文件URL处理。
400	InvalidImage.Category	输入图像与当前服务不符，例如，行驶证服务输入的图像不是行驶证。
400	InvalidImage.Content	输入图像内容不合法。例如：无效的base64编码图像；输入的image是空字符串；无效的image content；图像解码失败；输入的image不是合法的base64字符串；请删除base64字符串多余的头：data:image/jpg:base64；base64编码的数据长度必须是4的倍数，如果长度不够，需要在末尾加上`=`补齐；输入的image不是合法的base64字符串，存在非法字符。
400	InvalidImage.Decode	请检查图片是否能够正常打开。
400	InvalidImage.Download	图片无法下载，请检查本地网络情况、链接是否可访问、OSS链接是否过期等。非上海OSS图片链接，请参见文件URL处理。URL中不支持空格和中文字符，如包含请通过URLEncode编码之后再传入。
400	InvalidImage.Gif	GIF图像打开失败、读取失败、解码失败、获取颜色映射表错误或图像为空。
404	InvalidImage.NotFoundFace	图像中没找到人脸，请检查您的图像中是否包含人脸或人脸太小。
400	InvalidImage.Region	图片所在地域错误。
400	InvalidImage.Resolution	文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试。
400	InvalidImage.Timeout	图片下载超时，请检查本地网络情况、链接是否可访问、OSS链接是否过期等。非上海OSS文件链接，请参见文件URL处理。
400	InvalidImage.Type	图片类型错误，请检查图片类型，参考算法API文档，使用算法支持的图片类型。
400	InvalidImage.Unsafe	URL不安全。
415	InvalidImage.UnsupportedMediaType	输入的image解码失败。
400	InvalidImage.URL	图片链接非法，请检查图片链接是否可访问，非上海OSS图片链接，请参见文件URL处理。对于上海OSS链接请使用标准的OSS域名，目前暂不支持绑定CDN域名和自定义域名。
400	InvalidImageType	无效的图片类型。
400	InvalidOutputFormat	无效的输出格式。
400	InvalidParameter	参数值校验不通过。请使用请求参数构造规范化的请求字符串。详细信息请参见请求签名。
400	InvalidParameter.BadRequest	参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。
400	InvalidParameter.NotFound	参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。
400	InvalidParameter.TooLarge	待检测内容过大，请确保待检测内容在API的限制范围内。
400	InvalidRamRole	没有RAM权限，请联系主账号给您添加AliyunVIAPIFullAccess权限，操作流程，请参见使用RAM Policy控制访问权限。
400	InvalidResult	OCR识别失败、OCR识别异常。
400	InvalidSide	参数Side无效。
400	InvalidTimeStamp.Expired	用户时间和服务器时间相差超过15分钟，请检查您的时间戳设置，确保用户时间和服务器时间的差值在15分钟内。
400	MissingAccessKeyId	缺少AccessKeyID信息。具体请参见创建AccessKey。
400	MissingAssureDirection	缺少AssureDirection参数信息。
400	MissingImageURL	缺少图像URL参数。
400	MissingMinHeight	缺少MinHeight参数。
400	MissingOutputFormat	缺少输出格式。
400	MissingSide	缺少Side信息。
400	MissingSkipDetection	缺少SkipDetection参数。
400	MissingUseFinanceModel	缺少UseFinanceModel参数信息。
400	ParameterError	参数错误，请检查参数值。
503	ServiceUnavailable	服务不可用，如果服务器已经返回了RequestId，请通过钉钉群（23109592）联系我们。
400	SignatureDoesNotMatch	签名不匹配。请检查AccessKeyID和AccessKeySecret是否正确；检查签名方法是否正确。关于签名的详细信息请参见请求签名。
400	SignatureNonceUsed	SignatureNonce重复。每次请求的SignatureNonce在15分钟内不能重复。
400	Throttling	触发限流，付费API请购买更高QPS，免费API如有特殊需求，请通过钉钉群（23109592）联系我们。说明触发限流时Throttling和Throttling.User都有可能出现，处理时都需要考虑。
400	MissingParameter	参数缺失，请参考文档检查参数值。
400	Throttling.User	该时段的流量已经超限。付费API请购买更高QPS，免费API如有特殊需求，请通过钉钉群（23109592）联系我们。说明触发限流时Throttling和Throttling.User都有可能出现，处理时都需要考虑。
408	Timeout	请求超时。
403	Unauthorized	RAM权限校验未通过，具体请参见使用RAM Policy控制访问权限。
403	UnsupportedHTTPMethod	HTTP请求方法不支持。

公共错误码

API的公共错误码请参见API错误中心。

处理建议

请求服务出现错误码提示，请参见错误码描述查看具体错误原因，并进行错误处理。针对一些常见高频的错误类型，此处提供一些错误处理建议供您参考。

URL类错误码
此类错误码一般都是文件URL不符合要求，例如URL不安全、无效。更多信息，请参见文件URL处理。
图像加载错误码
此类错误也可以看作是图像URL错误，例如图像下载错误、地域错误。当前系统推荐使用华东2（上海）地域，如果您通过OSS生成URL，那么您在OSS上创建的Bucket所属地域应该为华东2（上海）。更多信息，请参见文件URL处理。
参数类错误码
此类错误码一般是输入参数不符合要求，例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求，您可以参考对应API文档中的请求参数表格进行检查确认。
系统服务类错误码
如果出现此类错误码，建议您重新发起服务请求，如果问题依然存在，请在钉钉群组（23109592）中反馈问题。