# 调用API实现人脸检测
本章节提供了通过Postman调用FRS服务人脸检测API（V2）的样例，帮助您零编码快速体验并熟悉FRS服务的使用方法。
使用FRS服务API的详细步骤如下所示：
[步骤1：开通服务]
[步骤2：配置环境]
[步骤3：Token认证鉴权]
[步骤4：调用服务]
#### 准备工作
注册华为账号并开通华为云，并完成实名认证，账号不能处于欠费或冻结状态。
 #### 步骤1：开通服务
1. 登录[人脸识别服务控制台](https://console.huaweicloud.com/frs/?locale=zh-cn#/frs/management/faceRecognized)。
   控制台左上角默认显示服务部署在"华北-北京四"区域，请您根据业务需要选择对应区域，详细区域说明请参见[什么是区域和可用区域](https://support.huaweicloud.com/face_faq/face_06_0005.html)。
   
2. 单击左侧"委托授权"，完成OBS授权。
   图1服务授权   
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001657628789.png "点击放大") 
3. 选择需要使用的API，进行开通。 本示例中需开通人脸检测API（V2）。
   图2开通服务   
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001657428585.png "点击放大") 
 
 #### 步骤2：配置环境
1. 下载并安装Postman。 Postman建议使用7.24.0版本。
   
2. 下载人脸识别服务Postman配置文件。 下载地址：[FRS-API.postman_collection.json](https://frs-sdk.obs.cn-north-4.myhuaweicloud.com/FRS-API.postman_collection.zip)。
   
3. 导入配置文件。
   1. 打开并登录Postman。
   
   2. 单击左上角"File \> Import \> Import File \> Choose Files"导入配置文件。
      图3导入配置文件   
      ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001156044355.png "点击放大")
      配置文件导入成功后，将显示在Postman左侧导航栏中。
      图4配置文件   
      ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001109004486.png)
      ![](https://support.huaweicloud.com/qs-face/public_sys-resources/note_3.0-zh-cn.png)
      本配置文件中服务所属区域为"华北-北京四"，如果您在开通服务时，选择了其他区域，在执行步骤3、步骤4时请将配置文件中的所有"cn-north-4"字段替换为实际区域，服务部署的区域具体请参见[终端节点](https://support.huaweicloud.com/api-ocr/ocr_03_0062.html)。
      
    
 
 #### 步骤3：Token认证鉴权
Token是用户的访问令牌，承载了用户的身份、权限等信息，用户调用API接口时，需要使用Token进行鉴权。
1. 在Postman左侧导航栏中单击"get-token"配置文件。
2. 单击"Body"配置项。填写用户名、密码、账号名。 请登录["我的凭证"](https://console.huaweicloud.com/iam/#/myCredential)页面，复制IAM用户名、账号名至username、domainname参数处，并填写密码。
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001213214512.png "点击放大")
   ![](https://support.huaweicloud.com/qs-face/public_sys-resources/note_3.0-zh-cn.png)
   获取Token时，如果出现The userInfo is wrong、APIGW.0101、The username or password is wrong报错，请参见[如何处理账密报错](https://support.huaweicloud.com/face_faq/face_06_0053.html)。
   图5Token认证鉴权   
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001156052593.png "点击放大") 
3. 单击"Send"，发送请求，获取并复制Token。 获取返回结果"Headers"中的"X-Subject-Token"即为Token。
   关于token有效期的详细说明请参见[获取IAM用户Token（使用密码）](https://support.huaweicloud.com/api-iam/iam_30_0001.html)。
   图6获取Token   
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001109005268.png "点击放大") 
 
 #### 步骤4：调用服务
人脸识别API的请求Body参数中输入数据支持图片的Base64编码、图片文件和图片URL路径，本示例中使用图片文件。
1. 在Postman左侧导航栏中单击"03 face-detect by file"配置文件。
2. 登录[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)，获取"华北-北京四"区域的项目ID，替换配置文件URL中的{{project_id}}。
3. 单击"Headers"配置项。将获取的Token复制到{{X-Subject-Token}}中。
   图7修改配置文件   
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001156264021.png "点击放大") 
4. 单击"Body"配置项，上传需要进行人脸检测的图片。
   图8修改配置文件   
   ![](https://support.huaweicloud.com/qs-face/zh-cn_image_0000001109385032.png "点击放大") 
5. 单击"Send"，发送请求，获取调用结果。
   ```
   {
     "faces": [
       {
         "bounding_box": {
           "width": 174,
           "top_left_y": 37,
           "top_left_x": 22,
           "height": 174
         },
         "attributes": {
           "age": 35,
           "quality": {
              "total_score": 0.5869140625,
              "blur": 0.385498046875,
              "pose": 0.3349609375,
              "occlusion": 0.392333984375,
              "illumination": 0.3408203125
           },
            "expression": {
              "type": "happy",
              "probability": 0.74
           }
         }
       }
     ]
   }
   ```