# # SDK端上错误码：三端通用错误码定义，部分错误码为某端特有，在说明中有详细备注 |错误代码 |说明 | |---|---| |0 |成功 ** *（注：三端在端上都做了预处理，把各种认证成功结果都归一到了这个错误码，如果端上不关注错误细节，只需判断成功与否，可以只判断返回错误码是否为0）* ** | |\-2 |客户端上内部错误。一般出现在集成阶段，需检查logcat运行时的日志排查问题原因。 | |\-4 |您手动退出或因识别失败次数大于4次，导致客户端默认退出。 | |\-1000 |网络异常，请稍后再试 | |\-1001 |未知错误 | |\-1002 |人脸识别中断，请再试一次 | |\-1003 |活体识别失败，请再试一次 | |\-1004 |人脸算法初始化失败 | |\-1005 |算法参数设置失败 | |\-1006 |用户取消操作 | |\-1007 |用户取消证件识别 | |\-1008 |设备端核验请求数据封装异常（Android/Harmony端特有，iOS端无此错误码） | |\-2000 |身份证照片获取失败 | |\-2101 |调用类型校验失败，请检查活体类型设置 | |\-3000 |活体设置任务失败 | |\-3001 |数据包解析失败，请稍后重试网络数据包解析失败 | |\-3002 |请退出多屏模式，再重试一次（Android/Harmony端特有，iOS端无此错误码） | |\-3003 |无法使用相机，请检查是否打开相机权限 | |\-3004 |ios：无法使用相册，请检查是否打开相册权限|\ | |Android&Harmony：无法使用相册，请检查是否具备媒体访问权限 | |\-3006 |相册图片获取失败 | |\-3007 |拍照失败 | |\-3008 |页面加载失败，请稍后重试 | |\-4003 |操作太频繁，请稍后再试 | |\-5000 |下载模型失败，请重试 | |\-5001 |资源无需更新 | |\-5003 |资源还未下载 | |\-5004 |对应模型不存在 | |\-5005 |模型校验失败 | |\-5006 |需要下载新版本 | |\-5020 |比对初始化失败 | |\-5021 |比对失败，请确认是本人 | |\-6000 |tos信息错误, 请检查tos配置 | |50000+ |50000以上错误码，为透传服务端的错误码，请参考人脸核身服务端api的错误码说明 | # --- # SDK端上常见透传服务端错误码： |错误代码 |说明 | |---|---| |50500 |服务内部错误 | |50501 |数据源内部错误 | |50201 |缺少输入参数或输入参数为空 | |50200 |输入参数不合法 | |50206 |输入图片为空 | |50207 |输入图片解码失败 | |50207 |输入图片无法处理 | |60102 |输入图片未检测到人脸 | |50215 |最常见的服务端错误码，具体错误需要查看认证子错误码了解具体含义。认证子错误码说明见下方algorithm_base_resp说明。 | # --- # algorithm_base_resp子错误码说明产生子错误码通常说明请求已经通过前置的网关校验，到达真正的算法服务与数据源服务层。（***注：以下不包含一些已经废弃以及端上sdk不会出现的子错误码***） |认证子错误码(algorithm_base_resp) |认证子错误说明 |是否计费 | |---|---|---| |0 |认证一致 |是 | |100000 |服务内部错误 | | |100001 |数据源内部错误 | | |201201 |缺少输入参数或输入参数为空 | | |201202 |输入参数不合法 | | |201301 |输入图片为空 | | |201302 |输入图片解码失败 | | |201304 |输入图片无法处理 | | |201403 |触发了身份证号单日频控 | | |203101 |输入图片未检测到人脸 | | |210101 |输入认证字段不合格（空、不合法等） | | |210202 |身份证号无效或不符合规范 | | |210205 |身份证查询无结果 | | |210207 |认证不一致，姓名与身份证号不匹配 | | |210301 |人脸图格式不支持 |是 | |210302 |人脸图质量不合格/已损坏 |是 | |210303 |人脸图大小过小 |是 | |210306 |人脸图中存在多个人脸 | | |210308 |数据源库中的底图质量不合格 | | |210309 |数据源库中无该身份信息对应的底图 | | |210311 |人脸图不匹配 |是 | |210312 |服务端动作活体匹配不通过 | | |210313 |认证不一致，疑似本人 |是 | |210314 |认证不一致，待对比图像建模失败 |是 | |210701 |人脸图质量分数过低 | | |210702 |人脸图活体分数过低 | | |210703 |人脸图比对分数过低 | | |210704 |传入的token参数有误或已过期 | | |210705 |动作活体重试次数超过上限 | | |210706 |基准图质量过低 | | |210707 |基准图不合格 | | |210708 |基准图没有人脸 | | |210709 |获取基准图失败 | | |210713 |设备风险过高 | | |210801 |SDKData为空 | | |210802 |SDKData版本异常 | | |210804 |SDKData数据有误 | | |210805 |SDKData配置与设置的不相符 | | |210806 |SDK动作活体未通过 | | |210807 |获取SDKData失败 | | |210901 |阻塞式回调触发失败 | | # 更多说明：由于sdk中存在对于服务端返回错误的粗处理（如：将几种认证成功的错误码归一到端上错误码0），所以端上错误码逻辑可以以以上为准。更多细节可以详见[身份认证sdk返回内容说明](https://bytedance.feishu.cn/docx/B1lSdCTx1okBgkxbbONcE04snRq)中对于原始返回的说明

图像生成大模型