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

问题诊断中心

使用问题诊断中心可帮助开发者更高效地诊断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数量超出限制。请根据文档中的限制检查，如需调整限制请提交工单。
400 QuotaExceeded.ImageCount 人脸、Trace数量超出限制。请根据文档中的限制检查，如需调整限制请提交工单。
400 QuotaExceeded.FaceGroupCount 数据库数量超出限制。请根据文档中的限制检查，如需调整限制请提交工单。
400 QuotaExceeded.DbCount 数据库数量超出限制。请根据文档中的限制检查，如需调整限制请提交工单。
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如有特殊需求请提交工单。
500 InternalError.Mapping 内部算法处理错误。如有影响业务请提交工单。
500 InternalError 服务器内部错误。如有影响业务请提交工单。
500 InternalError.Algo 内部算法处理错误。如有影响业务请提交工单。
500 InternalError.Timeout 内部处理超时错误。如有影响业务请提交工单。
500 ServiceUnavailable 网络请求错误。请优先检查本地网络是否存在故障，例如局域网络等；如果服务器已经返回了RequestId，请提交工单。
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）中反馈问题。