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

人脸人体错误码

状态码 错误码 描述
400 InvalidImage.Download 图片下载失败。
400 InvalidImage.URL 无效的图片URL。
400 IllegalUrlParameter URL不合法。
400 InvalidImage.Unsafe URL不安全。
400 InvalidImage.Region 图片所在地域错误。
400 InvalidImage.Decode 图像解码失败。输入的image不是合法的base64字符串。
  • 请删除base64字符串多余的头： data:image/jpg:base64。
  • 输入的image不是合法的base64字符串，base64编码的数据长度需要是4的倍数，如果长度不够，需要再末尾加上=补齐。
  • 输入的image不是合法的base64字符串，存在非法字符。
400 InvalidParamter.Type 参数错误：无效的type。
400 InvalidParamter.BadRequest 参数异常错误。
400 Throttling.User 该时段流量已经超限。如果不能满足现有业务要求请提工单进行申请。
400 InvalidParameter.TooLarge 待检测内容过大，请确保检测的内容在API的限制范围内。
400 MissingImageURLA 缺少对比的URL参数。
400 MissingImageURLB 缺少对比的URL参数。
400 MissingTasks 缺少task参数。
400 NonsequenceParameter.Task 缺少list类型的task参数。
400 InvalidTimeStamp.Expired 用户时间和服务器时间差异超过15分钟，请检查您的时间戳设置，确认时间戳和服务器时间的差值是否在15分钟内。
403 InvalidApi.NotPurchase 服务未开通，请先开通服务。具体请参见服务开通。
403 Unauthorized 权限不足，请先进行授权操作。具体请参见使用RAM Policy控制访问权限。
403 UnsupportedHTTPMethod HTTP请求方法不支持。建议查看各个产品的API调用方式文档。
404 InvalidAccessKeyId.NotFound AccessKeyID找不到。请检查调用时是否使用了正确的AccessKey。
500 InternalError.Algo 系统内部错误算法。
500 InternalError.Server 系统内部错误工程。
500 InternalError.Remote 远程服务不可用。

公共错误码

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

处理建议

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

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

  • 图像加载错误码

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

  • 参数类错误码

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

  • 系统服务类错误码

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