检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
是否能退订服务，退订套餐包 服务开通后，不支持退订，不使用则不计费。 如果购买了套餐包，已购买套餐包不支持退订，购买前请确认。 父主题： 产品咨询类
人证核身服务（Identity Verification Solution，简称IVS）是结合人脸识别、文字识别等技术，对用户身份进行真实性核验。 人证核身服务以开放API的方式提供给用户，您可以根据本文档提供的API来使用服务。 在调用人证核身服务API之前，请确保已经充分了解人证核身服务相关概念，详细信息请参见产品介绍。
下方示例代码通过js将图片转换成base64编码。功能如下： 在页面加载完成后，给id为imgUpload的文件输入框添加了一个onchange事件监听器，当用户选择了一张图片后，就调用getBase64函数。 getBase64函数接收一个文件对象作为参数，然后创建一个FileReader对象，用来读取文件的内容。
份证内容及其边缘包含在图像内。 支持图像中身份证要求水平放置。 目前支持检测视频文件，或视频的Base64编码，不支持直接检测视频流，需要用户客户端自己获取视频流并保存成文件，然后调用活体检测接口。 视频文件大小不超过8MB，建议客户端压缩到200KB~2MB。 限制视频时长1～15秒。
企业项目ID。IVS支持通过企业项目管理（EPS）对不同用户组和用户的资源使用，进行分账。 获取方法：进入“企业项目管理”页面，单击企业项目名称，在企业项目详情页获取Enterprise-Project-Id（企业项目ID）。 企业项目创建步骤请参见用户指南。 说明： 说明： 创建企业项目后，在传参时，有以下三类场景。
附录 状态码 错误码 获取项目ID 获取账号ID
API 标准版（三要素） 证件版（二要素）
功能总览 功能总览 全部 三要素人证核身 二要素人证核身 活体人证核身 OBS 2.0支持 三要素人证核身 使用姓名、身份证号码、人脸图片（或人脸视频）三要素进行身份审核。 身份验证时，传入的数据为人脸图片、身份证信息。 提取身份证信息时，可以使用身份证正反面图片，也可以直接输入姓名、身份证号文本。
约束与限制 只支持“华北-北京四”区域。 只支持中国大陆身份证的识别。 支持港澳台居住证核验，证件信息需文本输入 只支持JPG格式，图片中人像需无遮挡。 图像数据，base64编码，要求base64编码后大小不超过4MB。 图像各边的像素大小在300到8000px之间。 图像中身
使用前必读 概述 调用说明 终端节点 约束与限制 基本概念
最新动态 本文介绍了人证核身服务IVS各特性版本的功能发布和对应的文档动态，新特性将在各个区域（Region）陆续发布，欢迎体验。 2021年08月 序号 功能名称 功能描述 阶段 相关文档 1 上线人证核身服务 通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。
API概览 人证核身服务根据不同场景提供多种API。 表1 接口说明 API 说明 标准版（三要素） 使用姓名、身份证号码、人脸图片三要素进行身份审核。 证件版（二要素） 使用姓名、身份证号码二要素进行身份审核。
入门实践 当您完成了调用API、调用SDK基本操作后，可以根据自身的业务需求使用IVS提供的入门实践。 表1 常用最佳实践 实践 描述 活体人证核身 该实践基于于华为云人证核身服务IVS和人脸识别服务FRS构建，通过动作活体检测判断操作用户是否为真人，并将检测结果与用户身份证信息
产品咨询类 如何开通服务，计费规则 是否能退订服务，退订套餐包
SDK简介 人证核身服务端SDK是对人证核身提供的REST API进行的封装，您可以直接继承服务端从而实现对人证核身服务的快速操作。 接口与API对应关系 表1 接口与API对应关系 接口 API 人证核身标准版（三要素） POST https://{endpoint}/v2.0/ivs-standard
错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTPS请求返回一个 4xx 或 5xx 的 HTTPS状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便尽快帮您解决问题。
使用流程简介 人证核身是指通过用户的身份证信息、人脸图片，与权威数据库进行比对，进而实现身份验证。 使用流程 图1 使用流程 使用前必读 用户需要具备编程能力，熟悉Java、Python、iOS、Android、Node.js编程语言。 IVS服务需要用户通过调用API接口，实现
错误码类 调用API报错IVS.0015怎么处理 改名字导致的校验不通过怎么处理 APIG.0101报错处理方法 APIG.0201报错处理方法 APIG.0301报错处理方法 APIG.0307报错处理方法 账密报错“The username or password is wrong
统计API使用量 IVS服务控制台支持查看API的总调用量、调用成功量、调用失败量。 如果您购买了套餐包，可在“套餐包管理”页面，查看已有的套餐包及使用详情。套餐包费用扣减规则请参见“产品介绍 > 计费说明”。
证件版（二要素） 使用身份证文本验证 使用身份证图片验证 父主题： API
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
