目标检测API接口返回的错误码信息_视觉智能开放平台-阿里云帮助中心

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

说明

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

问题诊断中心

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

目标检测错误码

状态码	错误码	描述
403	AuthFailed	授权失败，请检查RAM权限配置。
400	ClientError.IllegalArgument	请求参数错误，详情查看message信息。
409	Data.Exist	数据已经存在。
400	EntityNotExist.Role	没有RAM权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，具体操作，请参见使用RAM Policy控制访问权限。
400	IllegalUrlParameter	URL不合法，请检查URL能否正常打开，非上海OSS图片链接，请参见文件URL处理。
500	InternalError	服务器内部错误。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Algo	内部算法处理错误。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Convert	输入参数转换失败。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Decode	图像解码失败。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Env	初始化环境失败。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Mapping	内部算法处理错误，如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Model	模型加载错误。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Process	推理过程异常。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Timeout	算法服务内部处理超时错误，请稍后重试。如有影响业务，请通过钉钉群（23109592）联系我们。
500	InternalError.Transfer	下载或上传数据失败。请稍后重试。如有影响业务，请通过钉钉群（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	服务未开通，请先开通服务。
400	InvalidApi.OutOfService	产品未开通，请开通产品。
400	InvalidFile.Content	图片或视频文件的内容格式不正确。
400	InvalidFile.Decode	文件解码失败、
400	InvalidFile.Download	文件无法下载，请检查本地网络情况，以及链接是否可访问。非上海OSS文件链接，请参见文件URL处理。
400	InvalidFile.Region	文件URL格式不正确，必须是阿里云同Region的OSS文件地址。
400	InvalidFile.Resolution	图片或视频的分辨率错误。
400	InvalidFile.Type	文件类型错误，请检查文件类型，参考算法API文档，使用算法支持的文件类型。阿里云视觉智能开放平台能够读取文件并获取真实的文件类型，不是通过文件后缀名进行类型判断，只看文件后缀名是无效的，关于更多文件类型判断和处理信息，请参见文件类型判断和处理。
400	InvalidFile.URL	文件URL格式不正确，必须是阿里云同Region的OSS文件地址。
400	InvalidImage.Content	请参考算法文档检查图片内容，更换包含符合算法要求的图片。
400	InvalidImage.Decode	图片或视频文件的内容格式不正确。
400	InvalidImage.Download	图片无法下载，请检查本地网络情况、链接是否可访问、OSS链接是否过期等。非上海OSS图片链接，请参见文件URL处理。URL中不支持空格和中文字符，如包含请通过URLEncode编码之后再传入。
404	InvalidImage.NotFound	参数中的图片文件不存在。
404	InvalidImage.NotFoundFace	输入的图片中没有检测到人脸。
400	InvalidImage.Region	文件URL格式不正确，必须是阿里云同Region的OSS文件地址。
400	InvalidImage.Resolution	图片或视频的分辨率错误。
400	InvalidImage.Timeout	下载文件超时失败。
400	InvalidImage.Type	图片类型错误，请检查图片类型，参考算法API文档，使用算法支持的图片类型。
400	InvalidImage.URL	图片链接非法，请检查图片链接是否可访问，非上海OSS图片链接，请参见文件URL处理。对于上海OSS链接请使用标准的OSS域名，目前暂不支持绑定CDN域名和自定义域名。
400	InvalidParameter	请求参数错误。
400	InvalidParameter.BadRequest	请求的参数/数据有错误。
400	InvalidParameter.NotFound	请求的数据不存在。
400	InvalidParameter.TooLarge	文件大小超出限制。
400	InvalidParameter.Type	请求参数的数据格式错误。
400	InvalidParameter.Unsuitable	数据为空或不适合被处理。
400	InvalidParamter.Type	请求参数的数据格式错误。
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	参数错误，请检查参数值。
400	QuotaExceeded.DbCount	数据库数量超出限制。
400	QuotaExceeded.FaceGroupCount	数据库数量超出限制。
400	QuotaExceeded.FaceImageCount	人脸、Trace数量超出限制。
400	QuotaExceeded.ImageCount	人脸、Trace数量超出限制。
449	Retry	由于网络抖动等偶发原因导致失败，需要重试。
400	SDK.ServerUnreachable	SDK端错误。
503	ServiceUnavailable	服务不可用，如果服务器已经返回了RequestId，请通过钉钉群（23109592）联系我们。
500	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	请求或处理超时失败。
403	Unauthorized	RAM权限校验未通过，具体请参见使用RAM Policy控制访问权限。

公共错误码

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

处理建议

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

URL类错误码
此类错误码一般都是文件URL不符合要求，例如URL不安全、无效。更多信息，请参见文件URL处理。
图像加载错误码
此类错误也可以看做是图像URL错误，例如图像下载错误、地域错误。当前系统推荐使用华东2（上海）地域，如果您通过OSS生成URL，那么您在OSS上创建的Bucket所属地域应该为华东2（上海）。更多信息，请参见文件URL处理。
参数类错误码
此类错误码一般是输入参数不符合要求，例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求，您可以参考对应API文档中的请求参数表格进行检查确认。
系统服务类错误码
如果出现此类错误码，建议您重新发起服务请求，如果问题依然存在，请在钉钉群组（23109592）中反馈问题。