检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
在线调试 API Explorer在线调试工具提供API的检索、调试、代码示例生成功能。同时，集成开发环境CloudIDE，可完成代码的构建、调试、运行。 本章节以证件版（二要素）API为例，介绍如何使用API Explorer调试API。 前提条件 注册华为账号并开通华为云，并
准备工作 开通人证核身服务 登录人证核身控制台。 在控制台左上角选择区域为“北京四”，并开通“人证核身标准版（三要素）”。 开通后，默认为按需计费。 图1 开通“人证核身标准版（三要素）” 开通人脸识别服务 登录人脸识别控制台。 在控制台左上角选择区域为“北京四”，并开通“动作活体检测”。
通过python将图片转成base64编码 下方示例代码以Python为例，介绍如何将d:\demo.jpg图片转换成base64编码。您也可以使用在线的图片转base64工具。 import base64 with open("d:\demo.jpg", "rb") as image_file:
参数类型 描述 req_data 否 Array of StandardReqDataByNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 StandardReqDataByNameAndId 参数 是否必选 参数类型 描述 verification_name
于实名认证时公安系统是根据汉字编码进行比较，而这些生僻字PUA编码和GB18030编码并不一致，所以核验不会通过。 解决方案： 通过第三方网站提供的生僻字查询功能，传入生僻字以其他方式编码的姓名进行核验（https://name.vurls.cn/ui/index/uigen/）。
req_data 否 Array of StandardReqDataByVideoAndNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 StandardReqDataByVideoAndNameAndId 参数 是否必选 参数类型 描述
参数类型 描述 req_data 否 Array of ExtentionReqDataByNameAndId objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ExtentionReqDataByNameAndId 参数 是否必选 参数类型 描述 verification_name
是否必选 参数类型 描述 req_data 否 Array of ReqDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ReqDataByIdCardImage 参数 是否必选 参数类型 描述 idcard_image1
开始使用 动作活体检测视频采集要求 表1 动作活体检测视频检测要求 活体检测动作 动作示例 视频动作说明 左摇头 √，左摇头幅度正常。 ×，左摇头幅度过大，超出画面。 右摇头 √，右摇头幅度正常。 ×，右摇头幅度过大，超出画面。 点头 √，点头幅度正常 ×，点头幅度过大，超出画面。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身份证区域有效占比超过15%，保证整张身份证内容及其边缘包含在图像内。
描述 req_data 否 Array of ReqDataByVideoAndIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ReqDataByVideoAndIdCardImage 参数 是否必选 参数类型 描述 idcard_image1
描述 req_data 否 Array of ExtentionReqDataByIdCardImage objects 请求列表，用于支持批量调用。目前暂时只支持单个数据查询。 表5 ExtentionReqDataByIdCardImage 参数 是否必选 参数类型 描述 idcard_image1
APIG.0201报错处理方法 如果调用API时返回错误信息与错误码："error_msg":"Backend timeout.","error_code":"APIG.0201"，表示请求超时。 您可以尝试以下方案进行解决。 使用Postman等工具直接调用服务，查看是否成功，
调用SDK实现人证核身证件版（二要素） 人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。 人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。 使用IVS SDK的详细步骤如下所示： 步骤1：开通服务
入门实践 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息
方案概述 应用场景 该解决方案基于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息关联起来，使用人证核身技术，实现对用户身份真实性的核验。 适用于金融保险、物流快递、游戏、互联网、差旅住宿等多种行业的账号实名注
败不计费。 账单数据与IVS控制台API调用量，会因时间差原因，导致两方数据有差异。账单数据通常都是有滞后性的，需要在某个时间节点之后开始批量计算费用。而调用量的上报跟用户的实际调用也有滞后，一般数据统计可能延迟10-20分钟。整体上，在完整月度账单出来后，或者查询历史上某个特定
资源与成本规划 该解决方案主要部署如下资源，需要的产品列表和配置示例如表1、表2所示，以下花费仅供参考。 表1 产品配置说明 产品 配置示例 人脸识别服务 区域：华北-北京四 计费模式：按需计费 涉及服务：动作活体检测 人证核身服务 区域：华北-北京四 计费模式：按需计费 涉及服务：人证核身标准版（三要素）
功能总览 功能总览 全部 三要素人证核身 二要素人证核身 活体人证核身 OBS 2.0支持 三要素人证核身 使用姓名、身份证号码、人脸图片（或人脸视频）三要素进行身份审核。 身份验证时，传入的数据为人脸图片、身份证信息。 提取身份证信息时，可以使用身份证正反面图片，也可以直接输入姓名、身份证号文本。
IdcardResult 身份证图像文字识别结果结构体。 表1 结构体说明 参数 类型 描述 name String 身份证上识别的名称。 number String 身份证号。 sex String 性别。 birth String 出生日期。 ethnicity String
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
