业务状态码
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 | 文件错误：文件无效或下载错误，可能的原因包括： - 文件下载超时 - 文件链接无法访问（服务器返回 4xx 或 5xx），或文件链接有误 - 文件大小超出限制 - 文件格式不支持 |
15 | 参数错误：其他参数校验错误 |
16 | 参数错误：指定识别任务 (TaskId) 时，该应用 (SID) 找不到指定的任务 |
17 | 超出并发：每秒请求数量超出限制 |
18 | 参数错误：正常文件过少，活体检测的图片数量不能少于 7，人脸对比不能少于 2 |
19 | 参数错误：超出单次请求的文件数量限制 |
20 | 参数错误：人脸对比、活体认证的头像图片无效 |
21 | 参数错误：重复提交相同流地址，该流地址已有正在处理的任务 |
22 | 参数错误：语音任务不存在，或已过期 |
23 | 参数错误：未配置/开通语音任务 |
24 | 参数错误：开通的应用 (SID) 任务类型与调用接口类型不匹配 |
25 | 回调错误（已弃用） |
26 | 参数错误：无效的人脸特征校验应用 (SID) |
27 | 参数错误：无效的人脸特征 ID，应用 (SID) 需要同时开通人脸实名认证任务和人脸校验任务 |
28 | 服务错误：提交异步图片任务失败 |
29 | 异步任务：任务不存在，或已过期失效 |
30 | 异步任务：任务正在排队等待处理 |
31 | 异步任务：任务正在处理 |
32 | 异步任务：任务已被取消 |
33 | 异步任务：任务处理失败 |
100 | 服务错误 |
101 | 未知错误（通常由于某个模型超时或无实例导致） |
2. 流结束状态码
| code | 说明 |
|---|---|
51000 | 流结束：推流端停止推流，或一段时间内无法获取新的流数据 |
51001 | 流状态异常：流地址或协议错误、流数据异常或流服务器错误 |
51002 | 流状态异常：流中无视频或语音数据流 |
51003 | 流状态异常：拉流过程中，流提前结束 |
51004 | 拉流异常：连接超时，或拉流超时 |
51005 | 拉流异常：无法拉流，流服务器拒绝连接 |
51006 | 拉流异常：拉流出错，任务结束 |
| --- | --- |
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 | 查找错误 |
4. 自定义人物名单状态码
| code | 说明 |
|---|---|
71000 | 自定义人物：未检测到人脸 |
71001 | 自定义人物：检测到多个人脸 |
71002 | 自定义人物：检测到人脸，但不符合入库要求 |
71003 | 自定义人物：其他错误 |
71004 | 自定义人物：图片读取错误 |
71005 | 自定义人物：其他错误 |
71006 | 自定义人物：其他错误 |
71007 | 自定义人物：图片读取错误 |
71008 | 自定义人物：人脸已经存在 |
71009 | 自定义人物：图片超过大小限制 |
71010 | 自定义人物：其他错误 |
71011 | 自定义人物：其他错误 |
5. 更新日志
| 日期 | 说明 |
|---|---|
| 2024-08-09 | 调整并明确流结束状态码，新增 51000~51006，标记 51400~52501 为待废弃 |