服务公共状态码解析
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 | 查找错误 |