# 调用SDK实现人证核身证件版（二要素）
人证核身服务软件开发工具包（IVS SDK）是对人证核身服务提供的REST API进行的封装，以简化用户的开发工作。
人证核身证件版（二要素）API为例，介绍如何使用IVS Python SDK。
使用IVS SDK的详细步骤如下所示：
[步骤1：开通服务]
[步骤2：安装SDK]
[步骤3：获取示例代码]
[步骤4：调用服务]
#### 准备工作前提条件
账号完成实名认证，且不能处于欠费或冻结状态。
 #### 步骤1：开通服务
1. 登录[人证核身服务控制台](https://console.huaweicloud.com/ivs)。
2. 选择需要使用的服务，在操作列单击"开通服务"。本示例中开通人证核身证件版（二要素）API。
   图1开通服务   
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000002108533828.png "点击放大") 
3. 服务开通成功后，开通状态显示"已开通"。
![](https://support.huaweicloud.com/qs-ivs/public_sys-resources/note_3.0-zh-cn.png)
首次使用服务时，需要先申请开通该服务。服务只需要开通一次即可，后面使用时无需再次申请。如未开通服务，调用服务时会提示IVS.0015报错。
 #### 步骤2：安装SDK
1. 获取并安装IVS Python SDK。 以PyCharm为例，介绍如何安装SDK。
   在PyCharm中新建一个项目，并单击左下方"Terminal"按钮。分别执行以下命令安装SDK（该SDK支持Python3及以上版本）。
   ```
   # 安装核心库
   pip install huaweicloudsdkcore
   # 安装IVS服务库
   pip install huaweicloudsdkivs
   ```
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000001253752887.png "点击放大")
   
2. 检查SDK是否已正确安装。 在PyCharm中选择"Settings \> Project \> Python Interpreter"，检查SDK是否已正确安装。
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000001253632935.png "点击放大")
   
 
 #### 步骤3：获取示例代码
获取人脸检测SDK示例代码。
1. 登录[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=IVS&api=DetectExtentionByNameAndId)，在"代码示例"中选择"Python"。
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000001253434213.png "点击放大")
   
2. 填写请求Body参数。输入数据填写uuid、verification_name、verification_id
   - uuid：唯一标识此次请求的ID，用户自定义，不超过64位。例如10eb0091-887f-4839-9929-cbc884f1e20e
   
   - verification_name：被验证人的姓名
   
   - verification_id：被验证人的身份证号码
   
   
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000001253634217.png "点击放大")
   
3. 复制代码示例至PyCharm中。
 
 #### 步骤4：调用服务
1. 获取AK/SK，替换代码示例中的"\<YOUR AK\>"、"\<YOUR SK\>"参数。 登录[我的凭证 \> 访问密钥](https://console.huaweicloud.com/iam/#/myCredential)页面，新增访问密钥，或使用已有的访问密钥。访问密钥为credentials.csv文件，包含AK/SK信息。
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000001253554175.png "点击放大")
   
2. 运行代码示例，获取识别结果。 识别结果返回"valid"，表示认证成功。
   ![](https://support.huaweicloud.com/qs-ivs/zh-cn_image_0000001208954236.png "点击放大")