当API请求发生错误时,服务端会返回错误信息。本文档为您介绍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文档中的请求参数表格进行检查确认。
- 系统服务类错误码
如果出现此类错误码,建议您重新发起服务请求,如果问题依然存在,请在钉钉群组(23109592)中反馈问题。