当API请求发生错误的时候,服务端会返回错误信息。本文档为您介绍API返回的错误码信息。
内容安全错误码
HTTP 状态码 | 错误代码 | 描述 |
---|---|---|
200 | - | 请求成功。 |
400 | InvalidParameter.BadRequest | 请求有误,通常是请求参数不正确导致的,请检查请求参数。 |
400 | MissingScene | 缺少scene参数信息。 |
400 | MissingTask | 缺少task参数。 |
400 | InvalidTask.N.ImageTimeMillisecond | 参数Task.N.ImageTimeMillisecond取值无效。 |
401 | InvalidImage.Unsafe | 请求失败,通常是由于使用了不安全的图片/视频/语音链接地址。 |
403 | RamRoleAuth | 请先为角色授权。 |
403 | UnsupportedHTTPMethod | HTTP请求方法不支持。 |
403 | InvalidApi.NotPurchase | 服务未开通,请先开通服务。具体请参见能力开通。 |
403 | InvalidImage.Unaccessable | 请求访问失败,通常是由于您的图片/视频/语音链接无法访问导致,请确认公网是否可以访问,并且无防盗链策略。 |
404 | InvalidImage.NotFound | 待检测内容未找到,通常是由于您的图片/视频/语音内容无法下载导致,请确认内容可通过公网访问到。 |
429 | Throttling | 请求频率超出配额。 |
480 | InvalidImage.Restriction | 下载失败,请确认待检测内容的大小、分辨率(如果有)在API的限制范围内。 |
500 | InternalError | 一般是服务端临时出错。建议重试,若持续返回该错误码,请提交工单处理。 |
580 | InternalError.DB | 数据库操作失败。建议重试,若持续返回该错误码,请提交工单。 |
581 | InternalError.Timeout | 请求超时。建议重试,若持续返回该错误码,请提交工单。 |
585 | InternalError.Cache | 缓存出错。建议重试,若持续返回该错误码,请提交工单。 |
586 | InternalError.Algo | 算法出错。请提交工单。 |
587 | InternalError.MiddleWare | 中间件出错。请提交工单。 |
400 | InvalidParameter.TooLarge | 待检测内容过大,请确保待检测的内容在API的限制范围内。建议重试,若持续返回该错误码,请提交工单。 |
400 | InvalidParameter.Format | 待检测内容格式错误,请确保待检测的内容在API的限制范围内。 |
400 | InvalidImage.Timeout | 下载超时,下载时间限制为3秒,请确保待检测的内容大小在API的限制范围内。 |
591 | InternalError.ConnectPool | 连接池满。请提交工单。 |
595 | InternalError.Frame | 截帧失败,请提交工单。 |
公共错误码
API的公共错误码请参见API错误中心。
处理建议
请求服务出现错误码提示,请参见错误码描述查看具体错误原因,并进行错误处理。针对一些常见高频的错误类型,此处提供一些错误处理建议供您参考。
- URL类错误码
此类错误码一般都是文件URL不符合要求,例如URL不安全、无效。建议确认当前URL是否正确,或者您可以重新生成URL,具体请参见生成URL。
- 图像加载错误码
此类错误也可以看做是图像URL错误,例如图像下载错误、地域错误。当前我们仅支持
华东2(上海)
地域,如果您通过OSS生成URL,那么您在OSS上创建的Bucket所属地域应该为华东2(上海)
。 - 参数类错误码
此类错误码一般是输入参数不符合要求,例如参数缺失、参数类型错误等。建议您检查输入参数是否符合要求,您可以参考对应API文档中的请求参数表格进行检查确认。
- 系统服务类错误码
如果出现此类错误码,建议您重新发起服务请求,如果问题依然存在,请在钉钉群组(32665857)中反馈问题。
在文档使用中是否遇到以下问题
更多建议
匿名提交