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

视频理解错误码

状态码 错误码 描述
400 InvalidParameter 入参非法。
InvalidParameter.Format 入参格式错误。
MissingParameter 入参缺失。
InvalidParameter.BadRequest 入参缺失或非法。
InvalidFile.Resolution 文件分辨率非法。
InvalidFile.Download 文件无法下载。
InvalidFile.Decode 文件无法解码。
InvalidFile.Category 文件内容类目不符合要求。
InvalidFile.Content 数据为空或不适合被处理。
InvalidFile.Type 文件类型非法。
InvalidFile.Unsafe 不安全的文件链接。
InvalidFile.URL 非法的文件URL。
InvalidFile.Region 文件URL不属于指定的region。
500 InternalError 服务端错误。
InternalError.Model 模型加载错误。
InternalError.Algo 调用算法服务出错。
InternalError.Busy 算法服务忙。

公共错误码

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

处理建议

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

    此类错误码一般都是文件URL不符合要求,例如URL不安全、无效。建议确认当前URL是否正确,或者您可以重新生成URL,具体请参见生成URL

  • 图像加载错误码

    此类错误也可以看做是图像URL错误,例如图像下载错误、地域错误。当前我们仅支持华东2(上海)地域,如果您通过OSS生成URL,那么您在OSS上创建的Bucket所属地域应该为华东2(上海)

  • 参数类错误码

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

  • 系统服务类错误码

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