错误码
更新时间：2024-07-22
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
通用错误码信息可查看：https://ai.baidu.com/ai-doc/FACE/5k37c1ujz
人脸实名认证方案错误码列表（APP+H5）
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 4 | Open api request limit reached | Open API请求次数限制已达到上限 |
| 6 | no permission to access data | 没有访问数据的权限 |
| 17 | Open api daily request limit reached | Open API每日请求次数限制已达到上限 |
| 18 | Open api qps request limit reached | Open API QPS请求次数限制已达到上限 |
| 19 | Open api total request limit reached | Open API总请求次数限制已达到上限 |
| 100 | Invalid parameter | 无效的参数 |
| 110 | Access token invalid or no longer valid | 访问链接无效或已过期，请重新生成 |
| 111 | Access token expired | 访问链接已过期，请重新生成 |
| 200 | unsupported operation | 不支持的操作 |
| 283456 | 图片为空或格式不正确 | 上传的图片为空或格式不正确 |
| 283400 | 服务异常，请稍后再试 | 服务异常，请稍后再试，如频繁出现，可提交工单反馈 |
| 283458 | 当前链接已失效，请重试 | 当前链接已失效，请重新生成链接 |
| 283459 | 请从手机端扫描二维码访问继续认证流程 | 请从手机端扫描二维码，以继续认证流程 |
| 283460 | 视频文件过大，核验请求超时 | 上传的视频文件过大，导致核验请求超时 |
| 222202 | 图片中没有人脸 | 上传的图片中没有检测到人脸 |
| 222203 | 无法解析人脸 | 无法解析上传的人脸图片 |
| 223113 | 人脸有被遮挡 | 上传的人脸图片被遮挡 |
| 223114 | 人脸模糊 | 上传的人脸图片模糊不清 |
| 223115 | 人脸光照不好 | 上传的人脸图片光照不好 |
| 223116 | 人脸不完整 | 上传的人脸图片不完整 |
| 223129 | 人脸未面向正前方 | 上传的人脸图片未面向正前方 |
| 223121 | 质量检测未通过 左眼遮挡程度过高 | 上传的人脸图片中左眼被遮挡程度过高 |
| 223122 | 质量检测未通过 右眼遮挡程度过高 | 上传的人脸图片中右眼被遮挡程度过高 |
| 223123 | 质量检测未通过 左脸遮挡程度过高 | 上传的人脸图片中左脸被遮挡程度过高 |
| 223124 | 质量检测未通过 右脸遮挡程度过高 | 上传的人脸图片中右脸被遮挡程度过高 |
| 223125 | 质量检测未通过 下巴遮挡程度过高 | 上传的人脸图片中 |
| 223126 | 质量检测未通过 鼻子遮挡程度过高 | 鼻子被遮挡，无法正常检测 |
| 223127 | 质量检测未通过 嘴巴遮挡程度过高 | 嘴巴被遮挡，无法正常检测 |
| 223131 | 合成图检测未通过 | 检测到图片为合成图，不符合要求 |
| 223134 | image brightness is too low | 检测到图片光线过暗，不符合要求 |
| 216434 | 活体检测未通过 | 无法通过活体检测，可能存在欺诈行为 |
| 216501 | 没有找到人脸 | 无法在视频或图像中找到人脸 |
| 216508 | 视频中有多张人脸 | 视频或图像中存在多张人脸，无法识别 |
| 216509 | 视频中的声音无法识别 | 视频中的声音质量过差，无法识别 |
| 216510 | 动作活体模式验证时视频长度超过10s | 动作活体模式下，视频长度不能超过10秒 |
| 216511 | 语音文件不符合要求 | 语音文件质量不符合要求，无法识别 |
| 223050 | 语音验证未通过 | 语音验证未通过，无法确认身份 |
| 223051 | 唇语验证未通过 | 唇语验证未通过，无法确认身份 |
| 223052 | 动作验证未通过 | 动作验证未通过，无法确认身份 |
| 283738 | 颜色验证未通过 | 颜色验证未通过，无法确认身份 |
| 222350 | 公安网图片不存在或质量过低 | 公安网不存在此照片或照片质量过低 |
| 222351 | 身份证号与姓名不匹配 | 提交的身份证号与姓名不匹配 |
| 222355 | 身份证号码正确，公安库里没有对应的照片 | 身份证号码正确，但公安库里没有对应的照片 |
| 222356 | 验证的人脸图片质量不符合要求 | 提交的人脸图片质量不符合要求，无法确认身份 |
| 222360 | 身份核验未通过 | 身份核验未通过，无法确认身份 |
| 216600 | 身份证号码格式错误 | 身份证号码格式不正确 |
| 222022 | 身份证号码格式错误 | 身份证号码格式不正确 |
| 222023 | 名字格式错误 | 名字格式不正确 |
| 216601 | 身份证号和名字不匹配 | 提交的身份证号和姓名不匹配 |
| 283457 | 当前环境存在安全风险 | 当前环境检测触发了安全风控规则 |
| 283501 | 安全检验未通过 | 请求中的安全校验未通过，可能是请求被篡改或存在中间人攻击等风险 |
| 283421 | 应用不存在。App not exist. | 传入的应用 ID 不存在或已被删除 |
| 216612 | 系统繁忙 | 服务端暂时无法处理请求，建议稍后再试 |
| 283437 | Token无效或已过期，请重新生成 | 认证 token 已过期或无效，请重新生成 token 后再进行请求 |
| 283438 | 视频转码失败，请重试 | 视频文件转码失败，建议重新上传或选择其他视频文件 |
| 283439 | STS_Token 已经生成 | STS Token 已经生成过，请勿重复请求 |
| 283464 | 非法流程 | 当前请求的流程状态异常或非法 |
| 283461 | 人脸和对比源不匹配 | 人脸图片和传入的对比源不匹配，建议核对传入的数据是否正确 |
| 283462 | 比对源配置错误 | 对比源配置错误，建议核对传入的数据是否正确 |
| 283463 | 人脸图片质量检测未通过 | 人脸图片质量检测未通过，建议上传更清晰的图片 |
| 283465 | 人脸图片活体检测未通过 | 人脸图片活体检测未通过，建议重新采集图片或更换采集环境 |
| 283467 | 该PLAN_ID下未查询到图片文件 | 传入的 plan_id 下未查询到图片文件，建议核对传入的 plan_id 是否正确 |
| 283468 | BOS文件上传失败 | 文件上传至 BOS 失败，建议重新上传或检查上传权限是否正确 |
| 283469 | 用户请求的 body 是空 | 用户请求的 body 是空，请检查请求参数是否正确 |
| 283435 | 方案不存在。Plan not exist. | 传入的方案 ID 不存在或已被删除 |
| 283440 | 身份证照片不符合要求，请重新上传 | 上传的身份证照片不符合要求，建议重新上传符合要求的身份证照片 |
| 283442 | 身份证信息不合法，请重新填写 | 上传的身份证信息不合法，建议重新填写正确的身份证信息 |
| 283443 | 不可使用语音验证码 | 当前环境下不支持使用语音验证码，建议使用其他方式进行验证 |
| 283444 | 语音验证码生成失败，请重试 | 语音验证码生成失败，请检查参数是否正确或稍后再试 |
| 283447 | 验证失败，请稍后重新尝试 | 验证失败，请稍后重新尝试 |
| 283448 | 语音验证码不符合要求 | 语音验证码不符合要求，请重新生成验证码 |
| 283449 | 活体检测视频不符合要求，请重新上传 | 上传的活体检测视频不符合要求，建议重新上传符合要求 |
| 283450 | 认证尚未开始。Verification is not started yet. | 认证流程尚未开始 |
| 283451 | 认证处理中。Verification is running. | 认证流程正在处理中 |
| 283453 | 不可使用照片活体 | 不支持使用照片进行活体检测 |
| 283454 | 不可使用视频活体 | 不支持使用视频进行活体检测 |
| 283455 | 超出查询有效期。Result is expired. | 查询结果已经过期 |
| 283436 | Token生成失败，请重试 | 认证 token 生成失败，请重试 |
| 283502 | 视频文件上传 bos 失败 | 视频文件上传至 BOS 失败，请重新上传或检查上传权限是否正确 |
| 283503 | 对比源信息未传入 | 传入的对比源信息为空 |
| 283504 | 请上传正确的身份证照片 | 上传的身份证照片不符合要求，请重新上传符合要求的身份证照片 |
| 283505 | 请上传正确的身份证人像面 | 上传的身份证人像面不符合要求，请重新上传符合要求的身份证照片 |
| 283506 | 请上传正确的身份证国徽面 | 上传的身份证国徽面不符合要求，请重新上传符合要求的身份证照片 |
| 283507 | 不可使用身份证识别 | 不支持使用身份证进行人脸识别。 |
| 283601 | 重复推送错误信息 | 重复推送相同的错误信息 |
| 222038 | 证件号或国籍参数格式错误 | 传入的证件号或国籍参数格式不正确 |
| 300201 | 您已拒绝授权摄像头，如需继续，请点击重新拍摄 | 用户拒绝授权实时视频流获取，无法完成核验流程 |
| 300001 | 受当前环境限制（300001），请更换浏览器或设备重试 | 当前环境不兼容实时检测，且方案配置为不允许降级，无法完成核验流程 |
| 300002 | 受当前环境限制（300002），请更换浏览器或设备重试 | 当前环境不兼容实时视频录制，且方案配置为不允许降级，无法完成核验流程 |
| 999999 | 请确保是本人操作且正脸采集 | 请确保是本人进行操作且采集的人脸为正脸 |
| 223135 | video extract image spoofing check fail | 视频提取图片合成图检测失败 |
| 283511 | 服务异常 | 服务请求异常，请再次尝试 |
| 283512 | 调用上游服务超时 | 调用上游服务超时，请再次尝试 |
| 800001 | 采集超时 | 用户人脸采集流程超时 |
| 800002 | 炫瞳检测失败 | 用户炫瞳检测环节验证失败 |
| 283491 | 请先通过接口传入指定用户信息 | APP方案实名认证接口调用前请确保提前上报用户信息 |
| 283492 | 请先通过接口上传比对底图 | APP方案人脸比对接口调用前请确保提前上报底图 |
| 283520 | 请传入核验方式 | APP方案verify_token调用需要传入match_source字段 |
人脸实名认证系列接口错误码（API）
| 错误码 | 错误信息 | 说明 | 处理建议 |
|---|---|---|---|
| 222350 | police picture is none or low quality |
公安网图片不存在或 质量过低 |
此用户的信息没有 被公安数据覆盖到， 请将此次身份验证 转到人工进行处理 |
| 222351 | id number and name not match or id number not exist |
身份证号与姓名不匹配 | 可能身份证号码或 姓名填写错误， 请用户再次确认。 可能为作弊用户， 请增加审批环节 |
| 222022 | param[id_card_number] format error |
身份证号不符合格式要求 | 填写正确的身份证号 |
| 222023 | param[name] format error | 姓名格式错误 | 请检查姓名格式是否正确 |
| 222354 | id number not exist | 公安库里不存在此身份证号 | 对于公安数据缺失， 建议开设人工反馈渠道， 进行人工认证处理 |
| 222355 | ipolice picture not exist | 身份证号码正确，公安库里没有对应的照片 | 对于公安数据缺失， 建议开设人工反馈渠道， 进行人工认证处理 |
| 222356 | person picture is low quality | 验证的人脸图片质量不符合要求 | 确认图片上的人脸是否清晰 不能有多张人脸 图片大小不能超过600KB 请重新拍摄 |
| 222361 | network not available | 公安服务连接失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 282105 | image decrypt error | 图片解密失败 | 请重新尝试，确认下载SDK的appid与服务端请求appid是否一致 若尝试多次无效，请提交工单咨询 |
| 216201 | image format error | 图片格式失败 | 请检查传入的图片base64格式是否有误； 如您使用人脸离线采集SDK，可能为加密错误导致，请检查SDK文件 |
| 216100 | invalid param | 参数格式失败 | 请检查入参格式 |
| 282003 | missing required parameter（s) | 缺少必要参数 | 请检查入参是否完整 |
| 282000 | internal error | 服务器内部错误 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222041 | param[start_date] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222042 | param[end_date] format error | 参数格式错误 | 参考API说明文档，修改参数 |
H5活体检测接口错误码列表
| 错误码 | error_msg | 错误信息 | 描述 |
|---|---|---|---|
| 216430 | rtse/face service error | rtse/face 服务异常 | 请重新尝试 |
| 216431 | voice service error | 语音识别服务异常 | 请重新尝试 |
| 216432 | video service call fail | 视频解析服务调用失败 | 请重新尝试 |
| 216433 | video service error | 视频解析服务发生错误 | 请重新尝试，确认是否选择语音验证码但未上传音频，或语音验证码读取不正确 |
| 216500 | code digit error | 验证码位数错误 | 验证码错误， 请增加一层验证环节 |
| 216501 | not found face | 没有找到人脸 | 请查看上传视频是否包含人脸 |
| 216502 | session lapse | 当前会话已失效 | 请重新获取语音验证码 |
| 216505 | redis connect error | redis连接失败 | 请重新尝试 |
| 216506 | redis operation error | redis操作失败 | 请重新尝试 |
| 216508 | not found video info | 没有找到视频信息 | 请参考文档修改视频格式 |
| 216509 | voice can not identify | 视频中的声音无法识别 （声音过低或者有杂 音导致无法识别） |
请重新录制视频 |
| 216510 | video time is too long | 动作活体模式验证时视频长度超过10s | 请重新录制时长小于10s的视频 |
| 216511 | voice file error | 语音文件不符合要求 | 请重新录制视频 |
| 216512 | action verify must post session_id | 使用动作活体验证时必须使用会话id | 先调用验证码下发接口获取动作类型的验证码 |
| 216513 | detect_model param error | 检测模型参数错误 | 根据接口文档要求传递参数 |
| 216612 | system busy | 系统繁忙 | 请重新尝试，若多次尝试无效请提交工单解决 |
| 216908 | 视频中人脸质量较差 (返回信息中包含具体原因) |
视频中人脸质量过低 (返回的错误信息会包含 具体的错误信息包含 illumiantion(光照不足) angle(角度不好) blur (人脸模糊) occlusion(有遮挡) too large(人脸过大, 占屏幕2/3以上) 等原因 |
请重新录制视频 |
| 222027 | code length param error | 验证码长度错误 (最小值大于最大值) |
参考API说明文档，修改参数 |
| 222028 | param[min_code_length] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222029 | param[max_code_length] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222030 | param[match_threshold] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 223050 | voice similarity low error | 视频中的语音与语音验证码所对应数值相似度过低 | 请重新录制视频 |