当API请求发生错误时,服务端会返回错误信息。本文为您介绍视觉搜索API返回的错误码信息。
阿里云视觉智能开放平台各类目视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。
问题诊断中心
使用问题诊断中心可帮助开发者更高效地诊断API使用过程中的问题。
图像搜索错误码
状态码 | 错误码 | 描述 |
403 | AuthFailed | 授权失败,请检查RAM权限配置。 |
400 | ClientError.IllegalArgument | 请检查参数,如参数值所代表的数据库是否存在。 |
403 | EntityNotExist.Role | 没有RAM权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,具体操作,请参见使用RAM Policy控制访问权限。 |
400 | IllegalUrlParameter | URL不合法,请检查URL能否正常打开,非上海OSS图片链接,请参见文件URL处理。 |
586 | InternalError.Algo | 内部算法处理错误。如有影响业务,请通过钉钉群(23109592)联系我们。 |
500 | InternalError.Timeout | 算法服务内部处理超时错误,请稍后重试。如有影响业务,请通过钉钉群(23109592)联系我们。 |
400 | InvalidAccessKeyId.Inactive | AccessKeyID非法,请检查AccessKeyID是否被禁用,或者AccessKeyID和AccessKeySecret是否填写正确。 |
400 | InvalidAccessKeyId.NotFound | AccessKeyID未找到,请检查AccessKeyID和AccessKeySecret是否填写正确。 |
400 | InvalidAccessKeySecret | AccessKeyID或AccessKeySecret填写错误,请检查AccessKeyID和AccessKeySecret是否填写正确。 |
400 | InvalidAction.NotFound | 能力未找到,请检查类目与能力是否匹配,检查访问域名与能力是否匹配。更多信息,请参见访问域名。 选择合适编程语言根据实例代码作相关修改进行接入,具体操作,请参见SDK总览。 |
400 | InvalidApi.ForbiddenInvoke | 调用受限,请检查您调用的能力是否为受限能力,受限能力需要在控制台找到相应能力申请,经过审批或者手动激活之后才能调用。 如非上述情况,请检查账号是否欠费。 |
400 | InvalidApi.NotPurchase | 服务未开通,更多信息,请参见服务说明。 |
403 | 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.Content | 请参考算法文档检查图片内容,更换包含符合算法要求的图片。 |
400 | InvalidImage.Decode | 请检查图片是否能够正常打开。 |
400 | InvalidImage.Download | 图片无法下载,请检查本地网络情况、链接是否可访问、OSS链接是否过期等。非上海OSS图片链接,请参见文件URL处理。URL中不支持空格和中文字符,如包含请通过URLEncode编码之后再传入。 |
404 | InvalidImage.NotFoundFace | 图像中没找到人脸,请检查您的图像中是否包含人脸或人脸太小。 |
400 | InvalidImage.REGION | 图片链接地域错误,非上海OSS文件链接,请参见文件URL处理。 |
400 | InvalidImage.Resolution | 文件分辨率超出限制,请检查文件分辨率和内容,修改文件分辨率后重试。 |
400 | InvalidImage.Timeout | 图片下载超时,请检查本地网络情况、链接是否可访问、OSS链接是否过期等。非上海OSS文件链接,请参见文件URL处理。 |
400 | InvalidImage.Type | 图片类型错误,请检查图片类型,参考算法API文档,使用算法支持的图片类型。 |
400 | InvalidImage.URL | 图片链接非法,请检查图片链接是否可访问,非上海OSS图片链接,请参见文件URL处理。对于上海OSS链接请使用标准的OSS域名,目前暂不支持绑定CDN域名和自定义域名。 |
400 | InvalidParameter | 入参错误。 |
400 | InvalidParameter.BadRequest | 请求有误,通常是请求参数不正确导致的,请检查请求参数。 |
400 | InvalidParameter.NotFound | 参数错误,请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。 |
400 | InvalidParameter.TooLarge | 参数错误,文件大小超出限制,请参考算法API文档调整文件大小。 |
403 | InvalidRamRole | 没有RAM权限,请联系主账号给您添加AliyunVIAPIFullAccess权限,操作流程,请参见使用RAM Policy控制访问权限。 |
400 | InvalidResult | 参数错误,请参考文档检查参数值,检查文件内容。请检查是否图片内容不完整或者太模糊等。 |
400 | InvalidSide | Specified parameter Side is not valid. 请参考文档填写正确的Side参数。 |
400 | InvalidTimeStamp.Expired | 时间戳过期,请更新时间戳。 |
400 | MissingAccessKeyId | AccessKeyID未填写,请检查AccessKeyID和AccessKeySecret是否填写正确。 |
400 | MissingParameter | 参数缺失,请参考文档检查参数值。 |
400 | ParameterError | 参数错误,请检查参数值。 |
503 | ServiceUnavailable | 服务不可用,如果服务器已经返回了RequestId,请通过钉钉群(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 | 请求超时。 |
400 | Unauthorized | 没有RAM权限,请联系主账号给您添加AliyunVIAPIFullAccess权限,操作流程,请参见使用RAM Policy控制访问权限。 |
公共错误码
API的公共错误码请参见API错误中心。
处理建议
请求服务出现错误码提示,请参见错误码描述查看具体错误原因,并进行错误处理。针对一些常见高频的错误类型,此处提供一些错误处理建议供您参考。
URL类错误码
此类错误码一般都是文件URL不符合要求,例如URL不安全、无效。更多信息,请参见文件URL处理。
图像加载错误码
此类错误也可以看作是图像URL错误,例如图像下载错误、地域错误。当前系统推荐使用华东2(上海)地域,如果您通过OSS生成URL,那么您在OSS上创建的Bucket所属地域应该为华东2(上海)。更多信息,请参见文件URL处理。
参数类错误码
此类错误码一般是输入参数不符合要求,例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求,您可以参考对应API文档中的请求参数表格进行检查确认。
系统服务类错误码
如果出现此类错误码,建议您重新发起服务请求,如果问题依然存在,请在钉钉群组(23109592)中反馈问题。