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

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

问题诊断中心

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

人脸人体错误码

状态码 错误码 描述
400 InvalidParameter.BadRequest 请求的参数、数据有错误。
  1. found no feature: 人脸搜索添加人脸要求图片中有人脸,该错误提示图片中没有人脸数据或人脸较小情况下检测不到人脸。
  2. image contains * features, which is more than *: 人脸添加的图片中只能有1个人脸。
400 InvalidFile.Resolution 图片、视频的分辨率错误。请排查文件的格式是否在要求的限制范围内。
400 InvalidFile.Content 图片、视频文件的内容格式不正确。请排查文件的格式是否在要求的限制范围内。
400 InvalidFile.Decode 文件解码失败。请排查文件的格式是否在要求的限制范围内。
400 InvalidFile.Download 下载文件失败。请排查文件的读取权限、有效期设置是否设置正确。
400 InvalidFile.Type 图片、视频文件的内容格式不正确。请排查文件的格式是否在要求的限制范围内。
400 InvalidFile.URL 文件URL格式不正确,必须是阿里云同Region的OSS文件地址。检测文件是否OSS文件地址,检测是否同Region(如cn-shanghai)。
400 InvalidFile.Region 文件URL格式不正确,必须是阿里云同Region的OSS文件地址。检测文件是否OSS文件地址,检测是否同Region(如cn-shanghai)。
400 InvalidImage.Resolution 图片、视频的分辨率错误。请排查文件的格式是否在要求的限制范围内。
400 InvalidImage.Decode 图片、视频文件的内容格式不正确。请排查文件的格式是否在要求的限制范围内。
400 InvalidImage.Download 下载文件失败。请排查文件的读取权限、有效期设置是否设置正确。
400 InvalidImage.Timeout 下载文件超时失败。一般是文件较大或偶发的网络异常,请稍后重试。
400 InvalidImage.URL 文件URL格式不正确,必须是阿里云同Region的OSS文件地址。检测文件是否OSS文件地址,检测是否同Region(如cn-shanghai)。
400 InvalidImage.Region 文件URL格式不正确,必须是阿里云同Region的OSS文件地址。检测文件是否OSS文件地址,检测是否同Region(如cn-shanghai)。
400 InvalidParameter 请求参数错误。请根据文档中的参数定义和限制检查请求参数。
400 InvalidParameter.NotFound 请求的数据不存在,未添加或已删除。
400 InvalidParameter.TooLarge 文件大小超出限制。请根据文档中的参数定义和限制检查请求参数。
400 InvalidParameter.Type 请求参数的数据格式错误。请根据文档中的参数定义和限制检查请求参数。
400 InvalidParamter.Type 请求参数的数据格式错误。请根据文档中的参数定义和限制检查请求参数。
400 ClientError.IllegalArgument 请求参数错误,详情查看Message信息。
400 QuotaExceeded.FaceImageCount 人脸、Trace数量超出限制。请根据文档中的限制检查,如需调整限制,请通过钉钉群(23109592)联系我们。
400 QuotaExceeded.ImageCount 人脸、Trace数量超出限制。请根据文档中的限制检查,如需调整限制,请通过钉钉群(23109592)联系我们。
400 QuotaExceeded.FaceGroupCount 数据库数量超出限制。请根据文档中的限制检查,如需调整限制,请通过钉钉群(23109592)联系我们。
400 QuotaExceeded.DbCount 数据库数量超出限制。请根据文档中的限制检查,如需调整限制,请通过钉钉群(23109592)联系我们。
400 InvalidImage.URL 文件URL格式不正确或URL访问失败,必须是阿里云同Region的OSS文件地址。检测文件是否OSS文件地址,检测是否同Region(如cn-shanghai);检查该URL的文件是否存在、是否地址已经失效等。
403 Unauthorized RAM权限校验未通过。RAM用户缺少VIAPI的权限,请先进行授权。具体请参见使用RAM Policy控制访问权限
404 InvalidImage.NotFound 参数中的图片文件不存在。请排查文件是否存在,以及读取权限、有效期设置是否设置正确。
408 Timeout 请求或处理超时失败,请稍后重试。
409 Data.Exist 数据已经存在。请勿重复添加相同的数据。
449 Retry 由于网络抖动等偶发原因导致失败,请稍后重试。
417 Throttling 触发限流。付费API请购买更高QPS,免费API如有特殊需求,请通过钉钉群(23109592)联系我们。
500 InternalError.Mapping 内部算法处理错误。如有影响业务,请通过钉钉群(23109592)联系我们。
500 InternalError 服务器内部错误。如有影响业务,请通过钉钉群(23109592)联系我们。
500 InternalError.Algo 内部算法处理错误。如有影响业务,请通过钉钉群(23109592)联系我们。
500 InternalError.Timeout 内部处理超时错误。如有影响业务,请通过钉钉群(23109592)联系我们。
500 ServiceUnavailable 网络请求错误。请优先检查本地网络是否存在故障,例如局域网络等;如果服务器已经返回了RequestId,请通过钉钉群(23109592)联系我们。
400 SDK.ServerUnreachable SDK端错误。请排查客户端SDK的配置,如Region、Endpoint、局域网络等设置。
404 InvalidImage.NotFoundFace 输入的图片中没有检测到人脸。请确认图片中是否包含人脸,如果有人脸,请通过钉钉群(23109592)联系我们。
403 InvalidApi.NotPurchase 服务未开通,请先开通服务。具体请参见能力开通
403 Unauthorized 权限不足,请先进行授权。具体请参见使用RAM Policy控制访问权限
403 UnsupportedHTTPMethod HTTP请求方法不支持。建议查看各个产品的API调用方式文档。
404 InvalidAccessKeyId.NotFound AccessKeyID不存在。请检查调用时是否使用了正确的AccessKey。具体请参见创建AccessKey

公共错误码

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

处理建议

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

    此类错误码一般都是文件URL不符合要求,例如URL不安全、无效。建议确认当前URL是否正确,或者您可以重新生成URL,具体请参见生成URL

  • 图像加载错误码

    此类错误也可以看做是图像URL错误,例如图像下载错误、地域错误。当前系统仅支持华东2(上海)地域,如果您通过OSS生成URL,那么您在OSS上创建的Bucket所属地域应该为华东2(上海)

  • 参数类错误码

    此类错误码一般是输入参数不符合要求,例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求,您可以参考对应API文档中的请求参数表格进行检查确认。

  • 系统服务类错误码

    如果出现此类错误码,建议您重新发起服务请求,如果问题依然存在,请在钉钉群组(23109592)中反馈问题。