API返回的错误码详情_视觉智能开放平台-阿里云帮助中心

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

说明

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

问题诊断中心

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

人脸人体错误码

状态码	错误码	描述
403	AuthFailed	授权失败，请检查RAM权限配置.
400	ParameterError	参数错误，请检查参数值。
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	图像中未找到人脸，请检查您的图像中是否包含人脸或人脸太小，如果有人脸，请通过钉钉群（23109592）联系我们。
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	MissingParameter	参数缺失，请参考文档检查参数值。
400	QuotaExceeded.ImageCount	人脸、Trace数量超出限制，请根据文档中的限制检查，如需调整限制，请通过钉钉群（23109592）联系我们。
400	QuotaExceeded.FaceImageCount	人脸、Trace数量超出限制。请根据文档中的限制检查，如需调整限制，请通过钉钉群（23109592）联系我们。
400	QuotaExceeded.FaceGroupCount	数据库数量超出限制。请根据文档中的限制检查，如需调整限制，请通过钉钉群（23109592）联系我们。
400	QuotaExceeded.DbCount	数据库数量超出限制。请根据文档中的限制检查，如需调整限制，请通过钉钉群（23109592）联系我们。
449	Retry	由于网络抖动等偶发原因导致失败，需要重试。
400	SDK.ServerUnreachable	SDK端错误。
503	ServiceUnavailable	服务不可用，如果服务器已经返回了RequestId，请通过钉钉群（23109592）联系我们。
500	ServiceUnavailable	网络请求错误。请优先检查本地网络是否存在故障，例如局域网络等；如果服务器已经返回了RequestId，请通过钉钉群（23109592）联系我们。
500	InternalError.Mapping	内部算法处理错误。如有影响业务，请通过钉钉群（23109592）联系我们。
400	SignatureDoesNotMatch	签名不正确，请重新计算签名，具体操作，请参见请求签名。
400	SignatureNonceUsed	签名已经被使用过，请重新计算签名。具体操作，请参见请求签名。
400	Throttling	触发限流，付费API请购买更高QPS，免费API如有特殊需求，请通过钉钉群（23109592）联系我们。说明触发限流时Throttling和Throttling.User都有可能出现，处理时都需要考虑。
400	Throttling.User	该时段的流量已经超限。付费API请购买更高QPS，免费API如有特殊需求，请通过钉钉群（23109592）联系我们。说明触发限流时Throttling和Throttling.User都有可能出现，处理时都需要考虑。
408	Timeout	请求或处理超时失败。
403	Unauthorized	RAM权限校验未通过，更多信息，请参见使用RAM Policy控制访问权限。
403	UnsupportedHTTPMethod	HTTP请求方法不支持。建议查看各个产品的API调用方式文档。

公共错误码

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

处理建议

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

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