服务公共状态码解析

1. 公共状态码解析

code 说明
0 调用成功
1 授权失败。注意公钥和私钥不要改动任何内容,要与传到图普账号下的公钥配对,如果弄混了版本,可以重新生成公私钥,公钥重新上传,调用端使用新私钥;另外,有两种格式的私钥,需要由编程语言决定。查看详情
2 模型信息错误
3 没有上传文件
4 API版本号错误
5 API版本已弃用
6 secretId错误
7 任务id错误,secretId不能调用该任务
8 secretId状态异常
9 尚未上传证书
10 pipId 错误
11 没有callback参数
12 时间参数错误
13 没有配置计算任务或者都已关闭
14 文件传输错误, 详见下方错误信息详解
15 参数非法
16 指定识别任务时,该应用找不到与taskId配置的任务
17 并发数超出限制
18 正常文件过少。 活体检测的图片数量不能少于7,人脸对比不能少于2
19 超出单次请求的文件数量限制
20 人脸对比、活体认证的头像图片无效(下载失败、图片超大、格式非法等)
21 提交重复的语音流
22 语音任务不存在,或已过期
23 未配置/开通语音任务
24 开通的 secretId 任务类型与调用接口类型不匹配 (例如异步视频调用同步视频接口)
25 回调错误
26 无效人脸特征校验应用ID
27 无效人脸特征ID, 应用ID必须同时开通任务【人脸实名认证, 人脸校验】才可以使用此接口,请联系我们开通。
100 服务错误
101 未知错误

2. 文件传输错误 (code 14) 信息详解

错误信息 message 说明
maxBuffer exceeded 文件过大,默认限制是 10MB 以内,具体根据图普官方的限制。
Download fail. response statusCode: xxx 文件链接或文件资源无法访问。
Download fail. errMsg: timeout. 文件下载超时。5秒超时,重试两次。
Invalid type: ** 非法文件格式,详情参照使用的审核服务接口文档。
invalid urls 非法的文件链接,请检查送审的文件链接是否符合URL的标准。

示例:

{
    "code": 14,
    "message": "Download fail. errMsg: timeout.",
    "nonce": "0.8060262239627614",
    "timestamp": 1628654602388
}

3. 文件传输错误码

新增错误码 error 字段,方便客户判断具体的文件错误类型。目前支持的接口有:

  • 异步视频回调
错误码 说明
URL_EXPIRED 文件链接已超时失效(通常是指定了超时时间的对象存储地址)
NOT_FOUND 文件不存在(文件链接返回 404)
INVALID_URL 文件链接错误 (非正确链接格式, 或文件链接返回 400, 5XX 响应码)
INVALID_VIDEO_FILE 视频文件错误
DOWNLOAD_TIMEOUT 文件下载超时
CONNECT_FAILED 连接文件服务器超时(请检查是否配置了服务器白名单)
FILESIZE_EXCEEDED 文件大小超出限制
TASK_RECOGNIZE_FAILED 任务处理失败
SINK_RESULT_FAILED 通知回调失败

示例:

{
    "code": 14,
    "error": "VIDEO_URL_EXPIRED",
    "message": "video type error: application/xml, detail: ffprobe exited with code 1",
    "nonce": "0.8060262239627614",
    "timestamp": 1628654602388
}

4. 语音相关的状态码

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

5. 图片/文本名单状态码

code 说明
60801 删除图片/文本错误
60802 新增图片/文本错误
60803 存储图片/文本错误
60804 图片已存在
60805 图片格式不支持
60806 图片编码错误
60807 数据库错误
60808 图片下载错误
60809 url无效
60810 图片下载超时
60811 文本不存在
60812 资源不存在
60813 无下载权限
60814 新增图片/文本名单库错误
60815 删除图片/文本名单库错误
60816 更新图片/文本名单库错误
60817 查找错误

results matching ""

    No results matching ""