检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
本地调用 本章节以证件版（二要素）API为例，介绍如何使用IVS Python SDK在本地进行开发。 该接口使用姓名、身份证号码二要素进行身份审核，并将识别结果以JSON格式返回给用户。人证核身成功时，会返回校验通过信息；人证核身失败时，会返回校验失败的具体原因。
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
父主题： 如何调用API
具体的URI信息请在各接口的API页面查看。 父主题： 错误码类
图10 查看识别结果
解决方案： 通过第三方网站提供的生僻字查询功能，传入生僻字以其他方式编码的姓名进行核验（https://name.vurls.cn/ui/index/uigen/）。 以更正信息为由到公安机关申请换证，以新的通用编码重新录入姓名。 父主题： 公共数据结构
IVS服务需要用户通过调用API接口，实现身份信息核验。API会返回JSON格式的识别结果，用户需要通过编码将识别结果对接到业务系统中。 关于人证核身服务的相关声明请参见人证核身服务免责声明。 人证核身服务等级协议请参见华为云服务等级协议。
图3 准备调试 请求方法选择“GET”，参考表填写查询参数。 表2 查询参数说明 参数名称 类型 是否必选 说明 actions String 是 动作代码顺序列表，英文逗号(,)分隔。
目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。 建议帧率10fps～30fps。
整体上，在完整月度账单出来后，或者查询历史上某个特定时间段账单最为精准。例如，查询上月的账单显示的调用量和统计调用量。 计费模式 按需计费 按需计费是指按照API调用次数阶梯价格计费，按月累计，一个自然月后次数清零重新累计。在控制台开通服务后，默认为按需计费。
OBS 2.0支持 活体人证核身 实现活体认证核身，有两种方案： （1）使用三要素API，传参时使用人脸视频进行验证。 （2）使用人脸识别服务（活体检测API）+人证核身服务（三要素API）。
接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard 人证核身证件版（二要素） POST https://{endpoint}/v2.0/ivs-idcard-extention
API 标准版（三要素） 证件版（二要素）
303 See Other 查看其它地址，使用GET和POST请求查看。 304 Not Modified 所请求的资源未修改，服务器返回此状态码时，不会返回任何资源。 305 Use Proxy 所请求的资源必须通过代理访问。
如何调用API 申请服务 构造请求 认证鉴权 返回结果
父主题： 如何调用API
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
标准版（三要素） 使用身份证图片、人脸图片验证 使用身份证文本、人脸图片验证 使用身份证图片、人脸视频验证 使用身份证文本、人脸视频验证 父主题： API
在我的凭证页面，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。
方案优势 权威可信 人证核身校验数据，来源自国家权威机构公安第一研究所和全国身份证信息查询中心。 简单易用 方案组合了人证核身和人脸识别的活体检测能力，并通过统一API对外提供服务。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
