内容审核API接口返回的错误码信息_视觉智能开放平台-阿里云帮助中心

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

说明

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

问题诊断中心

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

内容安全错误码

HTTP 状态码	错误代码	描述
403	AuthFailed	授权失败，请检查RAM权限配置。
400	ClientError.IllegalArgument	请检查参数，如参数值所代表的数据库是否存在。
403	EntityNotExist.Role	没有RAM权限，请联系主账号给你添加AliyunVIAPIFullAccess权限，具体操作，请参见使用RAM Policy控制访问权限。
400	IllegalUrlParameter	URL不合法，请检查URL能否正常打开，非上海OSS图片链接，请参见文件URL处理。
500	InternalError	服务器内部错误。如有影响业务，请通过钉钉群（23109592）联系我们。
586	InternalError.Algo	内部算法处理错误。如有影响业务，请通过钉钉群（23109592）联系我们。
585	InternalError.Cache	缓存出错。建议重试，若持续返回该错误码，请通过钉钉群（23109592）联系我们。
591	InternalError.ConnectPool	连接池满。请通过钉钉群（23109592）联系我们。
580	InternalError.DB	数据库操作失败。建议重试，若持续返回该错误码，请通过钉钉群（23109592）联系我们。
595	InternalError.Frame	截帧失败，请通过钉钉群（23109592）联系我们。
587	InternalError.MiddleWare	中间件出错。请通过钉钉群（23109592）联系我们。
581	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链接是否过期等。非上海OSS图片链接，请参见文件URL处理。URL中不支持空格和中文字符，如包含请通过URLEncode编码之后再传入。
404	InvalidImage.NotFound	待检测内容未找到，通常是由于您的图片/视频/语音内容无法下载导致，请确认内容可通过公网访问到。
400	InvalidImage.NotFoundFace	图像中没找到人脸，请检查您的图像中是否包含人脸或人脸太小
400	InvalidImage.REGION	图片链接地域错误，非上海OSS文件链接，请参见文件URL处理。
400	InvalidImage.Resolution	文件分辨率超出限制，请检查文件分辨率和内容，修改文件分辨率后重试。
480	InvalidImage.Restriction	下载失败，请确认待检测内容的大小或分辨率在API的限制范围内。
400	InvalidImage.Timeout	下载超时，下载时间限制为3秒，请确保待检测的内容大小在API的限制范围内。
400	InvalidImage.Type	图片类型错误，请检查图片类型，参考算法API文档，使用算法支持的图片类型。
403	InvalidImage.Unaccessable	请求访问失败，通常是由于您的图片/视频/语音链接无法访问导致，请确认公网是否可以访问，并且无防盗链策略。
401	InvalidImage.Unsafe	请求失败，通常是由于使用了不安全的图片/视频/语音链接地址。
400	InvalidImage.URL	图片链接非法，请检查图片链接是否可访问，非上海OSS图片链接，请参见文件URL处理。对于上海OSS链接请使用标准的OSS域名，目前暂不支持绑定CDN域名和自定义域名。
400	InvalidParameter	参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。
400	InvalidParameter.BadRequest	请求有误，通常是请求参数不正确导致的，请检查请求参数。
400	InvalidParameter.Format	待检测内容格式错误，请确保待检测的内容在API的限制范围内。
400	InvalidParameter.NotFound	参数错误，请根据算法API文档和报错Message检查参数值。是否参数值前后多了空格或者其他特殊字符等。
400	InvalidParameter.TooLarge	待检测内容过大，请确保待检测的内容在API的限制范围内。建议重试，若持续返回该错误码，请通过钉钉群（23109592）联系我们。
403	InvalidRamRole	没有RAM权限，请联系主账号给您添加AliyunVIAPIFullAccess权限，操作流程，请参见使用RAM Policy控制访问权限。
400	InvalidResult	参数错误，请参考文档检查参数值，检查文件内容。请检查是否图片内容不完整或者太模糊等。
400	InvalidSide	Specified parameter Side is not valid. 请参考文档填写正确的Side参数
400	InvalidTask.N.ImageTimeMillisecond	参数Task.N.ImageTimeMillisecond取值无效。
400	InvalidTimeStamp.Expired	时间戳过期，请更新时间戳。
400	MissingAccessKeyId	AccessKeyID未填写，请检查AccessKeyID和AccessKeySecret是否填写正确。
400	QuotaExceeded.ImageCount	人脸、Trace数量超出限制。
449	Retry	由于网络抖动等偶发原因导致失败，需要重试。
400	SDK.ServerUnreachable	SDK端错误。
503	ServiceUnavailable	服务不可用，如果服务器已经返回了RequestId，请通过钉钉群（23109592）联系我们。
500	ServiceUnavailable	网络请求错误。请优先检查本地网络是否存在故障，例如局域网络等。如果服务器已经返回了RequestId，请通过钉钉群（23109592）联系我们。
400	SignatureDoesNotMatch	没有RAM权限，请联系主账号给您添加AliyunVIAPIFullAccess权限，操作流程，请参见使用RAM Policy控制访问权限。
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控制访问权限。
403	UnsupportedHTTPMethod	HTTP请求方法不支持。建议查看各个产品的API调用方式文档。

公共错误码

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

处理建议

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

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