常见错误码

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

说明

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

问题诊断中心

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

商品理解错误码

状态码

错误码

描述

403

AuthFailed

授权失败,请检查RAM权限配置。

400

EntityNotExist.Role

没有RAM权限,请联系主账号给你添加AliyunVIAPIFullAccess权限,具体操作,请参见使用RAM Policy控制访问权限

400

IllegalUrlParameter

URL不合法。

500

InternalError

服务器内部错误。如有影响业务,请通过钉钉群(23109592)联系我们。

500

InternalError.Algo

内部算法处理错误。如有影响业务,请通过钉钉群(23109592)联系我们。

500

InternalError.Busy

后台服务忙。

500

InternalError.Device

CPU/GPU device初始化失败。

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

调用受限,请检查您调用的能力是否为受限能力,受限能力需要在控制台找到相应能力并进行申请,经过审批之后才能调用。

如非上述情况,请检查账号是否欠费。

403

InvalidApi.NotPurchase

服务未开通,请先开通服务

400

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文件链接,请参见文件URL处理

400

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处理

400

InvalidParameter

CPU/GPU device初始化失败。

400

InvalidParameter.BadRequest

参数错误,请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。

400

InvalidParameter.NotFound

参数错误,请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。

400

InvalidParameter.TooLarge

参数错误,文件大小超出限制,请参考算法API文档调整文件大小。

400

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)联系我们。

400

Throttling.User

该时段的流量已经超限。付费API请购买更高QPS,免费API如有特殊需求,请通过钉钉群(23109592)联系我们。

408

Timeout

请求超时。

400

Unauthorized

RAM权限校验未通过,具体请参见使用RAM Policy控制访问权限

公共错误码

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

处理建议

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

  • URL类错误码

    此类错误码一般都是文件URL不符合要求,例如URL不安全、无效。更多信息,请参见文件URL处理

  • 图像加载错误码

    此类错误也可以看做是图像URL错误,例如图像下载错误、地域错误。当前系统推荐使用华东2(上海)地域,如果您通过OSS生成URL,那么您在OSS上创建的Bucket所属地域应该为华东2(上海)。更多信息,请参见文件URL处理

  • 参数类错误码

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

  • 系统服务类错误码

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

阿里云首页 阿里云视觉智能开放平台 相关技术圈