文档

文字识别常见错误码

更新时间:

当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)中反馈问题。