错误码
更新时间：2025-08-22
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
通用错误码信息可查看：https://ai.baidu.com/ai-doc/FACE/5k37c1ujz
1、流控及鉴权通用错误码
| 错误码 | 错误信息 | 描述 | 处理建议 |
|---|---|---|---|
| 2 | Service temporarily unavailable | 服务暂不可用 | 服务暂不可用，请再次请求，如果持续出现此类错误，请在控制台提交工单联系技术支持团队 |
| 4 | Open api request limit reached | 集群超限额 | 集群超限额，请再次请求，如果持续出现此类错误，请在控制台提交工单联系技术支持团队 |
| 6 | no permission to access data | 没有接口权限 | 请确认您调用的接口已经被赋权 常见问题是有V3版本权限，调用的是v2版本接口； 需要企业认证的，开通企业认证后一个小时左右即可使用。 |
| 17 | Open api daily request limit reached | 每天流量超限额 | 免费测试资源使用完毕，每天请求量超限额，已支持计费的接口，您可以在控制台人脸识别选择购买相关接口的次数包或开通按量后付费；邀测和未支持计费的接口，您可以在控制台提交工单申请提升限额 |
| 18 | Open api qps request limit reached | QPS超限额 | 可直接自助购买更多QPS、联系商务接口人、或者提交工单 |
| 19 | Open api total request limit reached | 请求总量超限额 | 免费测试资源使用完毕，每天请求量超限额，已支持计费的接口，您可以在控制台人脸识别选择购买相关接口的次数包或开通按量后付费；邀测和未支持计费的接口，您可以在控制台提交工单申请提升限额 |
| 100 | Invalid parameter | 无效的access_token参数 | token拉取失败，可以参考“Access Token获取”重新获取 |
| 110 | Access token invalid or no longer valid | Access Token失效 | token有效期为30天，注意需要定期更换，也可以每次请求都拉取新token |
| 111 | Access token expired | Access token过期 | token有效期为30天，注意需要定期更换，也可以每次请求都拉取新token |
2、方案功能接口错误码
2.1 获取verify_token接口
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 283513 | 请求参数错误 | 请求体非 json，检查 body |
| 283435 | 方案不存在。Plan not exist. | 方案 id 不存在，检查请求参数 |
| 283512 | 服务异常，请稍后再试 | redis 连接失败，请稍后尝试 |
| 283520 | 请传入核验方式 | app 方案 match_source 参数未传入，检查请求参数 |
| 216100 | invalid param | 参数格式错误 |
2.2 指定用户信息上报接口
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 283442 | 身份证信息不合法，请重新填写 | 上传的身份证信息不合法，建议重新填写正确的身份证信息 |
| 283513 | 请求参数错误 | 请求体非 json，检查 body |
| 283400 | 服务异常，请稍后再试 | 服务异常，请稍后再试，如频繁出现，可提交工单反馈 |
| 283458 | 当前链接已失效，请重试 | 当前链接已失效，请重新生成链接 |
| 216100 | invalid param | 参数格式错误 |
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
| 222038 | 证件号或国籍参数格式错误 | 传入的证件号或国籍参数格式不正确 |
2.3 对比图片上传接口
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 283463 | 人脸图片质量检测未通过 | 人脸图片质量检测未通过，建议上传更清晰的图片 |
| 283400 | 服务异常，请稍后再试 | 服务异常，请稍后再试，如频繁出现，可提交工单反馈 |
| 222915 | system busy | 服务异常，请稍后再试，如频繁出现，可提交工单反馈 |
| 283513 | 请求参数错误 | 请求体非 json，检查 body |
| 283462 | 比对源配置错误 | 对比源配置错误，建议核对传入的数据是否正确 |
| 283465 | 人脸图片活体检测未通过 | 非实时视频核验方案未通过，请重试 |
| 222202 | 图片中没有人脸 | 上传的图片中没有检测到人脸 |
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
| 283456 | 图片为空或格式不正确 | 上传的图片为空或格式不正确 |
| 222203 | 无法解析人脸 | 无法解析上传的人脸图片 |
3、验证后查询接口错误码
3.1 获取认证人脸接口
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 223120 | 活体检测未通过 | 此次活体检测结果为非活体 |
| 17 | Open api daily request limit reached | 每天流量超限额 |
| 300201 | 您已拒绝授权摄像头，如需继续，请点击重新拍摄 | 用户拒绝授权实时视频流获取，无法完成核验流程 |
| 283450 | 认证尚未开始。Verification is not started yet. | 认证流程尚未开始。 |
| 283451 | 认证处理中。Verification is running. | 认证流程正在处理中。 |
| 800001 | 采集超时 | 用户人脸采集流程超时 |
| 222351 | 证件号与姓名不匹配 | 提交的身份证号与姓名不匹配 |
| 300001 | 受当前环境限制（300001），请更换浏览器或设备重试 | 当前环境不兼容实时检测，且方案配置为不允许降级，无法完成核验流程 |
| 223050 | voice similarity low error | 视频中的语音与语音验证码所对应数值相似度过低 |
| 999999 | 请确保是本人操作且正脸采集 | 请确保是本人进行操作且采集的人脸为正脸 |
| 800002 | 炫瞳检测失败 | 用户炫瞳检测环节验证失败 |
| 216509 | 视频中的声音无法识别 | 视频中的声音无法识别（声音过低或者有杂音导致无法识别） |
| 223135 | video extract image spoofing check fail | 视频提取图片合成图检测失败 |
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
| 223115 | 人脸光照不好 | 上传的人脸图片光照不好 |
| 223052 | 动作验证未通过 | 动作验证未通过，无法确认身份 |
| 223051 | 唇语验证未通过 | 唇语验证未通过，无法确认身份 |
| 223133 | video extract image liveness check fail | 视频提取图片活体检测失败 |
| 223116 | 人脸不完整 | 上传的人脸图片不完整 |
| 216908 | 视频中人脸质量较差 | 视频中人脸质量过低 返回的错误信息会包含 illumiantion(光照不足) angle(角度不好) blur(人脸模糊) occlusion(有遮挡) too large(人脸过大,占屏幕2/3以上)等原因 |
| 222202 | 图片中没有人脸 | 上传的图片中没有检测到人脸 |
| 223122 | 质量检测未通过 右眼遮挡程度过高 | 上传的人脸图片中右眼被遮挡程度过高 |
| 223114 | 人脸模糊 | 人脸模糊 |
| 216510 | 动作活体模式验证时视频长度超过10s | 动作活体模式下，视频长度不能超过10秒 |
| 223125 | 质量检测未通过 下巴遮挡程度过高 | 上传的人脸图片中下巴遮挡程度过高 |
| 283516 | 留存视频上传失败 | 留存视频上传失败，请联系技术支持 |
| 223131 | 合成图检测未通过 | 合成图检测未通过 |
| 223126 | 质量检测未通过 鼻子遮挡程度过高 | 鼻子被遮挡，无法正常检测 |
| 223121 | 质量检测未通过 左眼遮挡程度过高 | 上传的人脸图片中左眼被遮挡程度过高 |
| 282000 | 请确保是本人操作且正脸采集 | 业务逻辑层服务异常，请稍后重试 |
| 283400 | 服务异常，请稍后再试 | H5 内部服务异常，请稍后重试 |
| 800006 | 录制视频过大 | 非实时方案视频录制超过 20M |
| 283512 | 服务异常，请稍后再试 | redis 服务异常，请稍后再试 |
| 223123 | 质量检测未通过 左脸遮挡程度过高 | 上传的人脸图片中左脸被遮挡程度过高 |
| 283455 | 超出查询有效期。Result is expired. | 查询结果已经过期 |
| 222023 | 名字格式错误 | 请检查姓名格式是否正确 |
| 223124 | 质量检测未通过 右脸遮挡程度过高 | 上传的人脸图片中右脸被遮挡程度过高 |
| 216909 | 请确保录制的视频中仅有一人 | 请确保录制的视频中仅有一人 |
| 223127 | 质量检测未通过 嘴巴遮挡程度过高 | 嘴巴被遮挡，无法正常检测 |
| 283457 | 当前环境存在安全风险 | 当前环境检测触发了安全风控规则 |
| 216502 | 当前会话已失效 | 请重新获取语音验证码 |
| 18 | Open api qps request limit reached | Open API QPS请求次数限制已达到上限 |
| 222915 | 人脸服务异常，请稍后再试 | 人脸服务异常，请稍后再试 |
| 300002 | 受当前环境限制（300002），请更换浏览器或设备重试 | 当前环境不兼容实时视频录制，且方案配置为不允许降级，无法完成核验流程 |
| 300201 | 您已拒绝授权摄像头, 如需继续, 请点击重新拍摄 | 用户拒绝授权实时视频流获取，无法完成核验流程 |
| 216433 | video service error | 视频解析服务发生错误 |
| 283512 | 调用上游服务超时 | 调用上游服务超时，请再次尝试 |
| 2 | 调用OpenAPI服务超时 | 调用OpenAPI服务超时，请再次尝试 |
| 222013 | param[image] format error | 参数格式错误 |
| 216201 | image format error | 图片格式失败，请检查传入的图片base64格式是否有误；若使用的是安全版本SDK则是图片解密失败 |
| 222022 | 身份证号码格式错误 | 身份证号码格式错误 |
| 222350 | 公安网图片不存在或质量过低 | 此用户的信息没有被公安数据覆盖到，请将此次身份验证转到人工进行处理 |
| 216431 | voice service error | 语音识别服务异常 |
| 283513 | 请求参数错误 | 请求体非 json，检查 body |
| 283511 | 请确保是本人操作且正脸采集 | VMS 网关服务异常，请稍后重试 |
| 216100 | invalid param | 参数格式错误 |
| 216512 | action verify must post session_id | 使用动作活体验证时必须使用会话id |
| 283449 | 活体检测视频不符合要求，请重新上传 | 上传的活体检测视频不符合要求，建议重新上传符合要求 |
| 222356 | 验证的人脸图片质量不符合要求 | 确认图片上的人脸是否清晰 不能有多张人脸 图片大小不能超过600KB 请重新拍摄 |
| 216612 | 系统繁忙 | 算子网关异常，请稍后再试 |
| 216498 | 长时间未检测到符合质量要求的人脸 | 长时间未检测到符合质量要求的人脸图片 |
| 216499 | 炫瞳检测超时 | 炫瞳环节检测超时 |
| 216530 | 认证尚未完成 | 认证流程尚未完成 |
3.2 查询认证结果接口
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 216100 | invalid param | 参数格式错误 |
| 283450 | 认证尚未开始。Verification is not started yet. | 认证流程尚未开始 |
| 222351 | 证件号与姓名不匹配 | 提交的身份证号与姓名不匹配 |
| 223120 | 活体检测未通过 | 此次活体检测结果为非活体 |
| 800001 | 采集超时 | 用户人脸采集流程超时 |
| 800002 | 炫瞳检测失败 | 用户炫瞳检测环节验证失败 |
| 216509 | 视频中的声音无法识别 | 视频中的声音无法识别（声音过低或者有杂音导致无法识别） |
| 223131 | 合成图检测未通过 | 合成图检测未通过 |
| 223051 | 唇语验证未通过 | 唇语验证未通过，无法确认身份 |
| 300001 | 受当前环境限制（300001），请更换浏览器或设备重试 | 当前环境不兼容实时检测，且方案配置为不允许降级，无法完成核验流程 |
| 223052 | 动作验证未通过 | 动作验证未通过，无法确认身份 |
| 283516 | 留存视频上传失败 | 留存视频上传失败，请联系技术支持 |
| 223116 | 人脸不完整 | 上传的人脸图片不完整 |
| 999999 | 请确保是本人操作且正脸采集 | 请确保是本人进行操作且采集的人脸为正脸 |
| 216510 | 动作活体模式验证时视频长度超过10s | 动作活体模式下，视频长度不能超过10秒 |
| 223050 | 语音验证未通过 | 视频中的语音与语音验证码所对应数值相似度过低 |
| 283451 | 认证处理中。Verification is running. | 认证流程正在处理中 |
| 300201 | 您已拒绝授权摄像头, 如需继续, 请点击重新拍摄 | 用户拒绝授权实时视频流获取，无法完成核验流程 |
| 216201 | 服务异常，请稍后再试 | 图片格式失败，请检查传入的图片base64格式是否有误；若使用的是安全版本SDK则是图片解密失败 |
| 283400 | 服务异常，请稍后再试 | H5 内部服务异常，请稍后重试 |
| 18 | Open api qps request limit reached | Open API QPS请求次数限制已达到上限 |
| 223122 | 质量检测未通过 右眼遮挡程度过高 | 上传的人脸图片中右眼被遮挡程度过高 |
| 223114 | 人脸模糊 | 采集的人脸图片模糊 |
| 222023 | 名字格式错误 | 请检查姓名格式是否正确 |
| 283457 | 当前环境存在安全风险 | 当前环境检测触发了安全风控规则 |
| 222202 | 图片中没有人脸 | 上传的图片中没有检测到人脸 |
| 300002 | 受当前环境限制（300002），请更换浏览器或设备重试 | 当前环境不兼容实时视频录制，且方案配置为不允许降级，无法完成核验流程 |
| 223127 | 质量检测未通过 嘴巴遮挡程度过高 | 嘴巴被遮挡，无法正常检测 |
| 800006 | 录制视频过大 | 非实时方案视频录制超过 20M |
| 223121 | 质量检测未通过 左眼遮挡程度过高 | 上传的人脸图片中左眼被遮挡程度过高 |
| 216908 | 视频中人脸质量较差 | 视频中人脸质量过低 |
| 283458 | 当前链接已失效，请重试 | 当前链接已失效，请重试 |
| 283512 | 服务异常，请稍后再试 | redis 服务异常，请稍后再试 |
| 222350 | 公安网图片不存在或质量过低 | 此用户的信息没有被公安数据覆盖到，请将此次身份验证转到人工进行处理 |
| 223125 | 质量检测未通过 下巴遮挡程度过高 | 上传的人脸图片中下巴遮挡程度过高 |
| 282000 | 服务异常，请稍后再试 | 业务逻辑层服务异常，请稍后重试 |
| 223133 | 服务异常，请稍后再试 | 视频提取图片活体检测失败 |
| 216909 | 请确保录制的视频中仅有一人 | 请确保录制的视频中仅有一人 |
| 223115 | 人脸光照不好 | 上传的人脸图片光照不好 |
| 223123 | 质量检测未通过 左脸遮挡程度过高 | 上传的人脸图片中左脸被遮挡程度过高 |
| 216431 | 服务异常，请稍后再试 | 语音识别服务异常 |
| 222022 | 身份证号码格式错误 | 身份证号码格式错误 |
| 222915 | 服务异常，请稍后再试 | 人脸服务异常，请稍后再试 |
| 216205 | 服务异常，请稍后再试 | 业务逻辑层服务异常，请稍后重试 |
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
| 283513 | 请求参数错误 | 请求体非 json，检查 body |
| 223135 | 服务异常，请稍后再试 | 视频提取图片合成图检测失败 |
| 223126 | 质量检测未通过 鼻子遮挡程度过高 | 鼻子被遮挡，无法正常检测 |
| 223124 | 质量检测未通过 右脸遮挡程度过高 | 上传的人脸图片中右脸被遮挡程度过高 |
| 2 | 服务异常，请稍后再试 | 调用OpenAPI服务超时，请再次尝试 |
| 216502 | 当前会话已失效 | 请重新获取语音验证码 |
| 283511 | 调用上游服务超时 | VMS 网关服务异常，请稍后重试 |
| 283518 | 数据不存在 | 核验结果留存异常，请稍后重试 |
| 216512 | 服务异常，请稍后再试 | 使用动作活体验证时必须使用会话id |
| 283449 | 活体检测视频不符合要求，请重新上传 | 上传的活体检测视频不符合要求，建议重新上传符合要求 |
| 216433 | 服务异常，请稍后再试 | 视频解析服务发生错误 |
| 216612 | 系统繁忙 | 算子网关异常，请稍后再试 |
| 216498 | 长时间未检测到符合质量要求的人脸 | 长时间未检测到符合质量要求的人脸图片 |
| 216499 | 炫瞳检测超时 | 炫瞳环节检测超时 |
| 216530 | 认证尚未完成 | 认证流程尚未完成 |
3.3 查询统计结果接口
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
3.4 实时方案视频获取
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 283450 | 认证尚未开始。Verification is not started yet. | 认证流程尚未开始 |
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
| 283512 | 服务异常，请稍后再试 | redis 服务异常，请稍后再试 |
| 283451 | 认证处理中。Verification is running. | 认证流程正在处理中。 |
| 283400 | 服务异常，请稍后再试 | H5 内部服务异常，请稍后重试 |
| 283458 | 当前链接已失效，请重试 | 当前链接已失效，请重新生成链接 |
3.5 核验及计费信息获取
| 错误码 | 错误信息 | 说明 |
|---|---|---|
| 0 | 核验成功 | 核验成功 |
| 2 | 服务异常，请稍后再试 | openapi 服务异常，请稍后再试 |
| 18 | Open api qps request limit reached | 用户流控qps限流 |
| 223120 | 活体检测未通过 | 采集图片未通过活体校验 |
| 999999 | 请确保是本人操作且正脸采集 | 请确保是本人进行操作且采集的人脸为正脸 |
| 283457 | 当前环境存在安全风险 | 当前环境检测触发了安全风控规则 |
| 223114 | 人脸模糊 | 上传的人脸图片模糊不清 |
| 222350 | 公安网图片不存在或质量过低 | 公安网不存在此照片或照片质量过低 |
| 222351 | 证件号与姓名不匹配 | 提交的身份证号与姓名不匹配，或户籍信息异常 |
| 223115 | 人脸光照不好 | 上传的人脸图片光照不好 |
| 800001 | 采集超时 | 用户人脸采集流程超时 |
| 223124 | 质量检测未通过 右脸遮挡程度过高 | 上传的人脸图片中右脸被遮挡程度过高 |
| 223052 | 动作验证未通过 | 动作验证未通过，无法确认身份 |
| 800006 | 录制视频过大 | 非实时方案视频录制超过 20M |
| 800002 | 炫瞳检测失败 | 用户炫瞳检测环节验证失败 |
| 282000 | 服务异常，请稍后再试 | 业务逻辑层服务异常，请稍后重试 |
| 222202 | 图片中没有人脸 | 上传的图片中没有检测到人脸 |
| 222023 | 名字格式错误 | 名字格式不正确。名字需不超过48位，且不包含特殊字符和数字 |
| 223121 | 质量检测未通过 左眼遮挡程度过高 | 上传的人脸图片中左眼被遮挡程度过高 |
| 223131 | 合成图检测未通过 | 合成图检测未通过 |
| 283516 | 留存视频上传失败 | 留存视频上传失败，请联系技术支持 |
| 222013 | 服务异常，请稍后再试 | 安全服务异常，请稍后再试 |
| 223125 | 质量检测未通过 下巴遮挡程度过高 | 上传的人脸图片中下巴遮挡程度过高 |
| 223127 | 质量检测未通过 嘴巴遮挡程度过高 | 嘴巴被遮挡，无法正常检测 |
| 216509 | 视频中的声音无法识别 | 视频中的声音质量过差，无法识别 |
| 223122 | 质量检测未通过 右眼遮挡程度过高 | 上传的人脸图片中右眼被遮挡程度过高 |
| 216510 | 动作活体模式验证时视频长度超过10s | 动作活体模式下，视频长度不能超过10秒 |
| 222356 | 验证的人脸图片质量不符合要求 | 提交的人脸图片质量不符合要求，无法确认身份 |
| 222022 | 身份证号码格式错误 | 身份证号码格式不正确 |
| 283512 | 服务异常，请稍后再试 | redis 服务异常，请稍后再试 |
| 222915 | 服务异常，请稍后再试 | 人脸服务异常，请稍后再试 |
| 223126 | 质量检测未通过 鼻子遮挡程度过高 | 鼻子被遮挡，无法正常检测 |
| 216908 | 视频中人脸质量较差 | 视频中人脸质量过低 返回的错误信息会包含 illumiantion(光照不足) angle(角度不好) blur(人脸模糊) occlusion(有遮挡) too large(人脸过大,占屏幕2/3以上)等原因 |
| 223050 | 语音验证未通过 | 语音验证未通过，无法确认身份 |
| 222361 | 服务异常，请稍后再试 | 人脸服务异常，请稍后再试 |
| 300001 | 受当前环境限制（300001）, 请更换浏览器或设备重试 | 当前环境不兼容实时检测，且方案配置为不允许降级，无法完成核验流程 |
| 300201 | 您已拒绝授权摄像头, 如需继续, 请点击重新拍摄 | 用户拒绝授权实时视频流获取，无法完成核验流程 |
| 216909 | 请确保录制的视频中仅有一人 | 请确保录制的视频中仅有一人 |
| 283400 | 服务异常，请稍后重试 | H5 内部服务异常，请稍后重试 |
| 283511 | 调用上游服务超时 | VMS 网关服务异常，请稍后重试 |
| 216502 | 当前会话已失效 | 当前会话已失效，请重新获取语音验证码 |
| 216501 | 没有找到人脸 | 无法在视频或图像中找到人脸 |
| 223123 | 质量检测未通过 左脸遮挡程度过高 | 上传的人脸图片中左脸被遮挡程度过高 |
| 216612 | 系统繁忙 | 算子网关异常，请稍后再试 |
| 216498 | 长时间未检测到符合质量要求的人脸 | 长时间未检测到符合质量要求的人脸图片 |
| 216499 | 炫瞳检测超时 | 炫瞳环节检测超时 |
| 216530 | 认证尚未完成 | 认证流程尚未完成 |