人脸人体常见错误码

当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是否填写正确。

400

InvalidDB.Status

数据库状态无效,已被冻结,如需解冻,请通过钉钉群(23109592)联系我们。

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