人脸识别

    错误码

    若请求错误,服务器将返回的JSON文本包含以下参数:

    • error_code:错误码。
    • error_msg:错误描述信息,帮助理解和解决发生的错误。

    例如Access Token失效返回:

    {
      "error_code": 110,
      "error_msg": "Access token invalid or no longer valid"
    }

    上述问题重新获取新的Access Token再次请求即可。

    接口流控及鉴权错误码

    错误码 错误信息 描述 处理建议
    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[] is null 必要参数未传入 参考API说明文档,修改参数
    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
    参数格式错误 参考API说明文档,修改参数
    222023 param[name] format error 参数格式错误 参考API说明文档,修改参数
    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说明文档,修改参数
    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张
    222300 add face fail 人脸图片添加失败 重新尝试
    222301 get face fail 获取人脸图片失败 请重新尝试,
    如果持续出现此类错误,
    请提交工单
    222302 system error 服务端请求失败 重新尝试
    222303 get face fail 获取人脸图片失败 请重新尝试,
    如果持续出现此类错误,请提交工单
    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永久有效
    223110 uid_list is too large uid_list包含数量过多 请按照文档提示
    设置user_list参数
    223111 dst group is 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 正在清理该用户组的数据 请等该用户组清理完毕后再对
    该组进行操作
    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度)
    请使用面向正前方的人脸图片

    公安验证接口错误码

    错误码 错误信息 说明 处理建议
    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 police picture not exist 身份证号码正确,公安库里没有
    对应的照片
    对于公安数据缺失,
    建议开设人工反馈
    渠道,进行人工认证处理
    222356 person picture is low quality 验证的人脸图片质量不符合要求 确认图片上的
    人脸是否清晰,
    不能有多张人脸,
    图片大小不能超过600KB
    222360 invalid name or id number 身份证号码或名字非法
    (公安网校
    验不通过)
    可能身份证号码或
    姓名填写错误,
    请用户再次确认。
    可能为作弊用户,
    请增加审批环节
    222361 network not available 公安服务连接失败 请重新尝试,
    若尝试多次无效,
    请提交工单咨询
    216600 id number format error 输入身份证格式错误 请检查后重新输入
    216601 id number and name not match 身份证号和名字匹配失败 请检查后重新输入

    H5活体检测接口错误码列表

    错误码 error_msg 错误信息 描述
    216430 rtse/face service error rtse/face 服务异常 请重新尝试
    216431 voice service error 语音识别服务异常 请重新尝试
    216432 video service call fail 视频解析服务调用失败 请重新尝试
    216433 video service error 视频解析服务发生错误 请重新尝试
    216434 liveness check fail 活体检测失败 请重新尝试
    216500 code digit error 验证码位数错误 验证码错误,
    请增加一层验证环节
    216501 not found face 没有找到人脸 请查看上传视频是否包含人脸
    216502 session lapse 当前会话已失效 请重新获取语音验证码
    216505 redis connect error redis连接失败 请重新尝试
    216506 redis operation error redis操作失败 请重新尝试
    216507 found many faces 视频中有多张人脸 请重新录制视频
    216508 not found video info 没有找到视频信息 请参考文档修改视频格式
    216509 voice can not identify 视频中的声音无法识别
    (声音过低或者有杂
    音导致无法识别)
    请重新录制视频
    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说明文档,修改参数
    上一篇
    人像特效API文档
    下一篇
    常见问题及排查