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

问题诊断中心

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

内容安全错误码

HTTP 状态码 错误代码 描述
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文档中的请求参数表格进行检查确认。

  • 系统服务类错误码

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