资讯 社区 文档 控制台
技术能力
语音技术
文字识别
人脸与人体
图像技术
语言与知识
视频技术
AR与VR
数据智能
场景方案
部署方案
行业应用
智能教育
智能医疗
智能零售
智能工业
企业服务
智能政务
信息服务
智能园区

错误码

若请求错误,服务器将返回的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

上一篇
常见问题及排查
下一篇
SDK文档