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

图像识别错误码

状态码 错误码 描述
200 - 请求成功。
400 InvalidImage.URL 无效的图片URL。
400 InvalidImage.Content 输入图像内容不合法。
  • 输入的image是空字符串。
  • 无效的base64编码图像。
  • 无效的image content。
400 InvalidImage.Decode 图像解码失败。输入的image不是合法的base64字符串。
  • 请删除base64字符串多余的头: data:image/jpg:base64。
  • base64编码的数据长度需要是4的倍数,如果长度不够,需要再末尾加上=补齐。
  • 存在非法字符。
400 InvalidImage.Download 图片下载失败。
400 InvalidImage.Region 图片所在地域错误。
400 InvalidImage.Resolution 图片分辨率不符合要求。您可以在对应API的图片限制中查看图片分辨率限制。
400 IllegalUrlParameter URL不合法。
400 InvalidImage.Unsafe URL不安全。
400 ParameterError 参数错误,请检查参数值。
400 Throttling.User 您这个时段的流量已经超限。如果不能满足现有业务要求请提工单申请。
400 InvalidTimeStamp.Expired 用户时间和服务器时间差异超过15分钟,请检查您的时间戳设置,确保时间戳和服务器时间的差值在15分钟内。
400 InvalidParameter.TooLarge 待检测内容过大,请确保待检测的内容在API的限制范围内。
400 InvalidAccessKeyId.Inactive AccessKeyID被禁用。请检查AccessKey是否正常可用。请使用状态为启用的AccessKey。
403 InvalidApi.NotPurchase 服务未开通,请先开通服务。具体请参见开通视觉智能开放平台服务
403 UnsupportedHTTPMethod HTTP请求方法不支持。建议查看各个产品的API调用方式文档。
403 AuthFailed 授权失败,请检查RAM权限配置。
403 RamRoleAuth 请先给角色授权。具体授权操作请参见使用RAM Policy控制访问权限
404 InvalidAccessKeyId.NotFound AccessKeyID找不到。请检查调用时是否使用了正确的AccessKey。
408 Timeout 请求超时。
500 InternalServerError 系统内部错误。
503 ServiceUnavailable 服务不可用。

公共错误码

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

处理建议

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

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

  • 图像加载错误码

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

  • 参数类错误码

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

  • 系统服务类错误码

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