错误码
更新时间：2023-05-09
若请求错误，服务器将返回的JSON文本包含以下参数：
- error_code：错误码。
- error_msg：错误描述信息，帮助理解和解决发生的错误。
例如Access Token失效返回：
{
"error_code": 110,
"error_msg": "Access token invalid or no longer valid"
}上述问题重新获取新的Access Token再次请求即可。
接口流控及鉴权错误码
| 错误码 | 错误信息 | 描述 | 处理建议 |
|---|---|---|---|
| 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 |
通用及业务错误码
| 错误码 | 错误信息 | 说明 | 处理建议 |
|---|---|---|---|
| 222001 | param[fieldName] is null | 必要参数未传入 | 参考API说明文档，传入必须的fieldName字段 |
| 222002 | param[start] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222003 | param[length] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222004 | param[op_app_id_list] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222005 | param[group_id_list] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222006 | group_id format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222007 | uid format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222008 | face_id format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222009 | quality_conf format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222010 | user_info format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222011 | param[uid_list] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222012 | param[op_app_id] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222013 | param[image] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222014 | param[app_id] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222015 | param[image_type] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222016 | param[max_face_num] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222017 | param[face_field] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222018 | param[user_id] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222019 | param[quality_control] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222020 | param[liveness_control] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222021 | param[max_user_num] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222022 | param[id_card_number] format error |
身份证号不符合要求，备注：中国大陆身份证号的每一位数字都有其生成规则，不可随意填写。 | 填写正确的身份证号 |
| 222023 | param[name] format error | 参数格式错误 | 请检查手机号、姓名、身份证号格式是否正确 |
| 222024 | param[face_type] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222025 | param[face_token] format error |
参数格式错误 | 参考API说明文档，修改参数 |
| 222026 | param[max_star_num] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 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说明文档，修改参数 |
| 222039 | param[face_sort_type] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222200 | request body should be json format | 该接口需使用 application/json的 格式进行请求 |
请修改接口格式为： application/json |
| 222201 | network not available | 服务端请求失败 | 重新尝试 |
| 222202 | pic not has face | 图片中没有人脸 | 检查图片质量 |
| 222203 | image check fail | 无法解析人脸 | 检查图片质量 |
| 222204 | image_url_download_fail | 从图片的url下载 图片失败 |
请确认url可公网访问 |
| 222205 | network not availablel | 服务端请求失败 | 重新尝试 |
| 222206 | rtse service return fail | 服务端请求失败 | 重新尝试 |
| 222207 | match user is not found |
未找到匹配的用户 | 请确认人脸库中 是否存在此用户 |
| 222208 | the number of image is incorrect |
图片的数量错误 | 多张图片请使用 json格式传输 |
| 222209 | face token not exist | face token不存在 | 请确认您操作的 人脸已创建成功； 若face_token未注册到 人脸库则有效期只有1小时 注册人脸库的 face_token永久有效 |
| 222210 | the number of user's faces is beyond the limit | 人脸库中用户下的人脸数目超过限制 | 当前每个用户下限制人脸数目最大20张 |
| 222213 | face size is too small | 人脸尺寸过小，请保证人脸区域在64*64以上 | 请重新尝试， 请重新上传符合人脸尺寸要求的图片 |
| 222214 | face are cartoon images | 请使用非卡通的人脸图像 | 请重新尝试， 请重新上传非卡通的人脸图像 |
| 222215 | face quality is not acceptable | 人脸属性编辑处理该图像失败，请使用其他图片 | 请使用其他图片重新上传 |
| 222300 | add face fail | 人脸图片添加失败 | 重新尝试 |
| 222301 | get face fail | 获取人脸图片失败 | 请重新尝试， 如果持续出现此类错误， 请提交工单 |
| 222302 | system error | 服务端请求失败 | 重新尝试 |
| 222303 | get face fail | 获取人脸图片失败 | 请重新尝试， 如果持续出现此类错误，请提交工单 |
| 222309 | image size is too small | 图片尺寸过小，请使用清晰的图片 | 请重新尝试， 请重新上传符合尺寸要求的图片 |
| 222152 | param[target] format error | 人脸属性编辑，target参数错误 | 请修改参数后重试 |
| 222514 | face editattrpro operation fail | 人脸属性编辑v2调用服务失败，请重试 | 请重试 |
| 223100 | group is not exist | 操作的用户组不存在 | 请确认您操作的 用户组已创建成功 |
| 223101 | group is already exist | 该用户组已存在 | 请不要重复创建用户组 |
| 223102 | user is already exist | 该用户已存在 | 请不要重复创建用户 |
| 223103 | user is not exist | 找不到该用户 | 请确认您操作的 用户已创建成功 |
| 223104 | group_list is too large | group_list包含组 数量过多 |
请按照文档提示 设置group_list参数 |
| 223105 | face is already exist | 该人脸已存在 | 请不要重复添加人脸 |
| 223106 | face is not exist | 该人脸不存在 | 请确认您操作的 人脸已创建成功； 若face_token未注册到 人脸库则有效期只有1小时， 注册人脸库的 face_token永久有效 |
| 223107 | scene_type not same | 人脸库中人脸复制时源组与目标组的scene_type不同 | scene_type不同的组之间用户不能复制 |
| 223110 | uid_list is too large | uid_list包含数量过多 | 请按照文档提示 设置user_list参数 |
| 223111 | dst group not exist | 目标用户组不存在 | 请确认您操作的 用户组已创建成功 |
| 223112 | quality_conf format error |
quality_conf格式不正确 | 请按照文档提示设置 quality_conf参数 |
| 223113 | face is covered | 人脸有被遮挡 | 提示用户请勿遮挡面部 |
| 223114 | face is fuzzy | 人脸模糊 | 人脸图片模糊， 前端页面可以提示 用户拍摄时不要晃动手机 |
| 223115 | face light is not good | 人脸光照不好 | 提示用户到光线适宜的地方拍摄 |
| 223116 | incomplete face | 人脸不完整 | 提示用户请勿遮挡面部 |
| 223117 | app_list is too large | app_list包含app数量 过多 |
请按照文档提示设置 app_list参数 |
| 223118 | quality control error | 质量控制项错误 | 请按照文档提示设置 质量控制参数 |
| 223119 | liveness control item error |
活体控制项错误 | 请按照文档提示设置 活体控制参数 |
| 223120 | liveness check fail | 活体检测未通过 | 此次活体检测结果为非活体 |
| 223121 | left eye is occlusion | 质量检测未通过 左眼 遮挡程度过高 |
提示用户请勿遮挡左眼 |
| 223122 | right eye is occlusion | 质量检测未通过 右眼 遮挡程度过高 |
提示用户请勿遮挡右眼 |
| 223123 | left cheek is occlusion | 质量检测未通过 左脸 遮挡程度过高 |
提示用户请勿遮挡左脸颊 |
| 223124 | right cheek is occlusion |
质量检测未通过 右脸 遮挡程度过高 |
提示用户请勿遮挡右脸颊 |
| 223125 | chin contour is occlusion |
质量检测未通过 下巴遮挡程度过高 | 提示用户请勿遮挡下巴 |
| 223126 | nose is occlusion | 质量检测未通过 鼻子遮挡程度过高 | 提示用户请勿遮挡鼻子 |
| 223127 | mouth is occlusion | 质量检测未通过 嘴巴 遮挡程度过高 |
提示用户请勿遮挡嘴巴 |
| 222901 | system busy | 参数校验初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222902 | system busy | 参数校验初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222903 | system busy | 参数校验初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222904 | system busy | 参数校验初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222905 | system busy | 接口初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222906 | system busy | 接口初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222907 | system busy | 缓存处理失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222908 | system busy | 缓存处理失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222909 | system busy | 缓存处理失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222910 | system busy | 数据存储处理失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222911 | system busy | 数据存储处理失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222912 | system busy | 数据存储处理失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222913 | system busy | 接口初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222914 | system busy | 接口初始化失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222915 | system busy | 后端服务连接失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222916 | system busy | 后端服务连接失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222304 | image size is too large | 图片尺寸太大 | 请确保图片尺寸在1920x1080以下 |
| 222305 | pic storage not support | 当前版本不支持图片存储 | 请确认face_token的使用符合规范 |
| 223128 | group was deleting | 正在清理该用户组的数据 | 请等该用户组清理完毕后再对 该组进行操作 |
| 223136 | images exist in this group | 该组内存在关联图片，无法新建相同名称组 | 需清理完该组下的数据后才能创建组 |
| 222361 | system busy | 公安服务连接失败 | 请重新尝试， 若尝试多次无效， 请提交工单咨询 |
| 222046 | param[template_type] format error | 参数格式错误 | 请参考接口文档修改 |
| 222101 | param[merge_degree] format error | 参数格式错误 | 请参考API说明文档，修改参数 |
| 222102 | param[face_location] format error | 参数格式错误 | 参考API说明文档，修改参数 |
| 222307 | image illegal, reason: porn | 图片非法 鉴黄未通过 | 请重新上传合法的图片 |
| 222308 | image illegal, reason: sensitive person | 图片非法 含有政治敏感人物 | 请重新上传合法的图片 |
| 222211 | template image quality reject | 人脸融合失败 模板图质量不合格 | 请检查模板图是否符合 人脸融合文档中的质量要求 |
| 222212 | merge face fail | 人脸融合失败 | 请更换素材后重新尝试， 如果持续出现此类错误，请提交工单 |
| 223129 | face not forward | 人脸未面向正前方 （人脸的角度信息大于30度） |
请使用面向正前方的人脸图片 |
| 223130 | spoofing_control item error | spoofing_control参数格式错误 | 请求参数spoofing_control的值不是接口文档指定的[‘NONE’, ‘LOW’, ‘NORMAL’, ‘HIGH’] 其中之一，修改请求参数 spoofing_control 值 |
| 223131 | spoofing check fail | 合成图检测未通过 | 此次活体检测结果为合成图攻击 |
| 223133 | video extract image liveness check fail | 视频提取图片活体检测失败 | 视频可能存在活体攻击 |
| 223052 | action identify fail | 视频中的动作验证未通过 | 请重新录制视频 |
| 223201 | param[scene_type] format error | 请求参数scene_type 格式错误 | 请检查请求参数 |
| 223202 | scene_type does not match | 识别时请求的scene_type与group设置的scene_type不匹配 | 检查请求参数 （此校验默认不开启） |
人脸实名认证系列接口错误码
| 错误码 | 错误信息 | 说明 | 处理建议 |
|---|---|---|---|
| 222350 | police picture is none or low quality |
公安网图片不存在或 质量过低 |
此用户的信息没有 被公安数据覆盖到， 请将此次身份验证 转到人工进行处理 |
| 222351 | id number and name not match or id number not exist |
身份证号与姓名不匹配 | 可能身份证号码或 姓名填写错误， 请用户再次确认。 可能为作弊用户， 请增加审批环节 |
| 222352 | name format error | 名字格式错误 | 姓名格式错误， 请确认用户姓名 是否输入正确 |
| 222353 | id number 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 | 视频中的语音与语音验证码所对应数值相似度过低 | 请重新录制视频 |
人脸实名认证方案错误码列表
| 错误码 | 错误信息 | 描述 |
|---|---|---|
| 283458 | 当前链接已失效，请重试 | 请检查是否为token不存在，或token已过期，token状态不对(核验成功后不能通过该token再次核验 或者 在方案里配置了『核验失败且只能验证一次』) |
| 283437 | Token无效或已过期，请重新生成 | token已过期 或者 token状态不对(同上) |
| 283450 | 认证尚未开始。Verification is not started yet | 用户还未进行核验，token状态必须是失败、成功、核验中 |
| 283451 | 认证处理中。Verification is running | token状态是核验中，请等一会再操作 |
| 283455 | 超出查询有效期。Result is expired | token过期，查询结果失败 |
| 283400 | 服务异常，请稍后再试 | 服务异常，可能原因：参数错误、查询结果不存在、处理失败等。多次操作依旧报错请联系管理员 |
| 283458 | 视频文件上传 bos 失败 | 多次操作依旧报错请联系管理员 |
| 283439 | STS_Token 已经生成 | STS临时token已经生成，等待过期后再操作(默认30s) |
| 283460 | 视频文件过大，核验请求超时 | 修改上传的视频文件 |
| 283437 | 对比源信息未传入 | 上传比对图片 |
| 283449 | 活体检测视频不符合要求，请重新上传 | 视频文件太大、太小、为空 |
| 100 | Invalid parameter | 参数异常，检查入参 |
更多H5人脸实名认证方案错误码参见https://ai.baidu.com/ai-doc/FACE/zl958mm8k