检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
是否支持生僻字识别，少数民族字体识别 支持部分生僻字识别。 不支持少数民族语言文字识别。 父主题： API使用类
Python SDK 本章节介绍人证核身服务Python SDK，您可以参考本章节进行快速集成开发。 准备工作 注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。 已开通人证核身服务。如未开通，请登录人证核身管理控制台开通所需服务。 已具备开发环境，支持Python3及以上版本。
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现身份信息核验。API会返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。
通过python将图片转成base64编码 下方示例代码以Python为例，介绍如何将d:\demo.jpg图片转换成base64编码。您也可以使用在线的图片转base64工具。 import base64 with open("d:\demo.jpg", "rb") as image_file:
概述 人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充
本地调用 本章节以证件版（二要素）API为例，介绍如何使用IVS Python SDK在本地进行开发。 该接口使用姓名、身份证号码二要素进行身份审核，并将识别结果以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。 前提条件 注
人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示： 步骤1：开通服务 步骤2：安装SDK 步骤3：获取示例代码 步骤4：调用服务 准备工作前提条件 账号完成实名认证，且不能处于欠费或冻结状态。 步骤1：开通服务 登录人证核身服务控制台。 选择需要使用
API使用类 查看API使用次数 是否支持生僻字识别，少数民族字体识别 接口的并发是多少 通过js将图片转成base64编码 通过python将图片转成base64编码
获取项目ID 从控制台获取项目ID 登录管理控制台。 鼠标移动到右上角的用户名上，在下拉列表中选择“我的凭证”。 在“我的凭证”页面，可以查看用户名、账号名，在项目列表中查看项目。 图1 查看项目ID 多项目时，展开“所属区域”，从“项目ID”列获取子项目ID。 调用API获取项目ID
Programming Interface，应用程序编程接口）的方式提供身份验证能力。用户调用API接口需要具备一定的编程开发基础，识别后返回的结果为JSON格式，用户需要通过编程来处理识别结果。 您可以选择合适的方式进行使用，使用前请参考申请服务开通所需要的API。 通过华为云API Explorer在线调用IVS服务API。
] } } 图9 填写请求Body 单击右上角“Send”按钮发送请求，查看识别结果。返回"valid"、"Successful certification"，表示身份验证成功。 图10 查看识别结果
准备工作 开通人证核身服务 登录人证核身控制台。 在控制台左上角选择区域为“北京四”，并开通“人证核身标准版（三要素）”。 开通后，默认为按需计费。 图1 开通“人证核身标准版（三要素）” 开通人脸识别服务 登录人脸识别控制台。 在控制台左上角选择区域为“北京四”，并开通“动作活体检测”。
资源与成本规划 该解决方案主要部署如下资源，需要的产品列表和配置示例如表1、表2所示，以下花费仅供参考。 表1 产品配置说明 产品 配置示例 人脸识别服务 区域：华北-北京四 计费模式：按需计费 涉及服务：动作活体检测 人证核身服务 区域：华北-北京四 计费模式：按需计费 涉及服务：人证核身标准版（三要素）
部署该解决方案会使用到如下资源： API网关：API托管服务， 通过APIG，对外提供人证核身和人脸识别的组合API能力。 函数工作流：用于实现人证核身和人脸识别的组合业务逻辑，并通过APIG对外提供服务。 人脸识别服务：提供动作活体检测功能，判断当前用户是否为真人。 人证核身服务：将活体检测截取
准备数据 数据要求 受技术与成本多种因素制约，IVS服务存在一些约束限制。 API只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验，证件信息需文本输入 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身
idcard_result IdcardResult object 身份证图像的文字识别结果，具体参见IdcardResult。 表10 IdcardResult 参数 参数类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String
idcard_result IdcardResult object 身份证图像的文字识别结果，具体参见IdcardResult。 表10 IdcardResult 参数 参数类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
