业务状态码
1. 通用业务状态码
| code | 说明 |
|---|---|
0 | 接口调用成功，或异步任务正常处理完成 |
1 | 参数错误：鉴权失败 |
2 | 配置错误：模型信息错误 |
3 | 参数错误：没有上传文件 |
4 | 参数错误：API 版本号错误 |
5 | 参数错误：API 版本已弃用 |
6 | 参数错误：应用 ID (SID) 格式错误，或无法获取应用配置 |
7 | 参数错误：识别任务 (TaskId) 错误 |
8 | 配置错误：应用 (SID) 状态异常 |
9 | 配置错误：尚未生成应用密钥 |
10 | 参数错误：PipId 错误（已弃用） |
11 | 参数错误：没有 callback 参数（已弃用） |
12 | 参数错误：时间参数错误（已弃用） |
13 | 参数错误：没有配置任务或任务都已关闭 |
14 | 文件错误：文件无效或下载错误，详见下方错误信息详解 |
15 | 参数错误：其他参数校验错误 |
16 | 参数错误：指定识别任务 (TaskId) 时，该应用 (SID) 找不到指定的任务 |
17 | 超出并发：每秒请求数量超出限制 |
18 | 参数错误：正常文件过少，活体检测的图片数量不能少于 7，人脸对比不能少于 2 |
19 | 参数错误：超出单次请求的文件数量限制 |
20 | 参数错误：人脸对比、活体认证的头像图片无效 |
21 | 参数错误：重复提交语音流 |
22 | 参数错误：语音任务不存在，或已过期 |
23 | 参数错误：未配置/开通语音任务 |
24 | 参数错误：开通的应用 (SID) 任务类型与调用接口类型不匹配 |
25 | 回调错误（已弃用） |
26 | 参数错误：无效的人脸特征校验应用 (SID) |
27 | 参数错误：无效的人脸特征 ID，应用 (SID) 需要同时开通人脸实名认证任务和人脸校验任务 |
28 | 服务错误：提交异步图片任务失败 |
29 | 异步图片结果不存在，识别未完成或结果已过期失效 |
100 | 服务错误 |
101 | 未知错误（通常由于某个模型超时或无实例导致） |
文件错误信息
当接口响应或回调状态码为 14 文件错误时，错误信息的含义参考如下：
| 错误信息 | 说明 |
|---|---|
max buffer exceeded | （图片）文件过大，默认情况下文件 base64 后的大小小于 1MB |
download fail. response status code: xxx | （图片）文件链接或文件资源无法访问 |
download fail. err msg: timeout | （图片）文件下载超时 |
invalid type: ** | （图片）文件格式非法，详情参照使用的审核服务接口文档 |
invalid urls | （图片）文件链接非法，例如文件链接不完整 |
URL_EXPIRED | （视频）文件链接已超时失效（通常是指定了超时时间的对象存储地址） |
NOT_FOUND | （视频）文件不存在（文件链接返回 404） |
INVALID_URL | （视频）文件链接错误 (非正确链接格式，或文件链接返回 400，5XX 响应码) |
INVALID_VIDEO_FILE | （视频）视频文件错误 |
DOWNLOAD_TIMEOUT | （视频）文件下载超时 |
CONNECT_FAILED | （视频）连接文件服务器超时（请检查是否配置了服务器白名单） |
FILESIZE_EXCEEDED | （视频）文件大小超出限制 |
示例:
{
"code": 14,
"message": "download fail. errMsg: timeout.",
"nonce": "0.8060262239627614",
"timestamp": 1628654602388
}
2. 语音流结束状态码
| code | 说明 |
|---|---|
51400 | 用户流地址出错，导致拉流中断，任务结束。如：Server return 5xx |
51401 | 用户流地址提前结束，拉流被迫中止，任务结束。如：Stream ends prematurely |
51402 | 无法拉流，使用的协议有误，任务结束。如：failed to read RTMP packet header |
51403 | 无法拉流，能连接到流服务器，但找不到流。可能跟 ffmpeg 版本有关，如：StreamNotFound |
51404 | 无法拉流，流地址不存在。如：No such stream，not Found |
51405 | 无法拉流，流数据非法。如：Invalid data found |
51408 | 拉流超时，任务结束。如：Operation timed out |
51410 | 长时间无法获取新的流数据，任务结束。 |
51417 | 无法拉流，流服务器拒绝了我们的连接，任务结束。如：Connection refused |
51500 | 未记录的错误，任务结束。 |
52412 | 拉流出错，任务结束。如：Input/output error |
52500 | 未知错误，任务结束。 |
52501 | 审核服务主动断开流，任务结束。如：Immediate exit requested |
3. 图片/文本名单状态码
| code | 说明 |
|---|---|
60801 | 删除图片/文本错误 |
60802 | 新增图片/文本错误 |
60803 | 存储图片/文本错误 |
60804 | 图片已存在 |
60805 | 图片格式不支持 |
60806 | 图片编码错误 |
60807 | 数据库错误 |
60808 | 图片下载错误 |
60809 | url 无效 |
60810 | 图片下载超时 |
60811 | 文本不存在 |
60812 | 资源不存在 |
60813 | 无下载权限 |
60814 | 新增图片/文本名单库错误 |
60815 | 删除图片/文本名单库错误 |
60816 | 更新图片/文本名单库错误 |
60817 | 查找错误 |