文档首页/ 人脸识别服务 FRS/ 快速入门/ 调用API实现人脸检测
更新时间:2024-04-19 GMT+08:00
分享

调用API实现人脸检测

本章节提供了通过Postman调用FRS服务人脸检测API(V2)的样例,帮助您零编码快速体验并熟悉FRS服务的使用方法。

使用FRS服务API的详细步骤如下所示:

步骤1:开通服务

步骤2:配置环境

步骤3:Token认证鉴权

步骤4:调用服务

准备工作

注册华为账号并开通华为云,并完成实名认证,账号不能处于欠费或冻结状态。

步骤1:开通服务

  1. 登录人脸识别服务控制台

    控制台左上角默认显示服务部署在“华北-北京四”区域,请您根据业务需要选择对应区域,详细区域说明请参见什么是区域和可用区域

  2. 单击左侧“委托授权”,完成OBS授权。
    图1 服务授权
  3. 选择需要使用的API,进行开通。

    本示例中需开通人脸检测API(V2)。

    图2 开通服务

步骤2:配置环境

  1. 下载并安装Postman。

    Postman建议使用7.24.0版本。

  2. 下载人脸识别服务Postman配置文件。

    下载地址:FRS-API.postman_collection.json

  3. 导入配置文件。
    1. 打开并登录Postman。
    2. 单击左上角“File > Import > Import File > Choose Files”导入配置文件。
      图3 导入配置文件

      配置文件导入成功后,将显示在Postman左侧导航栏中。

      图4 配置文件

      本配置文件中服务所属区域为“华北-北京四”,如果您在开通服务时,选择了其他区域,在执行步骤3、步骤4时请将配置文件中的所有“cn-north-4”字段替换为实际区域,服务部署的区域具体请参见终端节点

步骤3:Token认证鉴权

Token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用API接口时,需要使用Token进行鉴权。

  1. 在Postman左侧导航栏中单击“get-token”配置文件。
  2. 单击“Body”配置项。填写用户名、密码、账号名。

    请登录“我的凭证”页面,复制IAM用户名、账号名至username、domainname参数处,并填写密码。

    获取Token时,如果出现The userInfo is wrong、APIGW.0101、The username or password is wrong报错,请参见如何处理账密报错

    图5 Token认证鉴权
  3. 单击“Send”,发送请求,获取并复制Token。

    获取返回结果“Headers”中的“X-Subject-Token”即为Token。

    关于token有效期的详细说明请参见获取IAM用户Token(使用密码)

    图6 获取Token

步骤4:调用服务

人脸识别API的请求Body参数中输入数据支持图片的Base64编码、图片文件和图片URL路径,本示例中使用图片文件。

  1. 在Postman左侧导航栏中单击“03 face-detect by file”配置文件。
  2. 登录我的凭证,获取“华北-北京四”区域的项目ID,替换配置文件URL中的{{project_id}}。
  3. 单击“Headers”配置项。将获取的Token复制到{{X-Subject-Token}}中。
    图7 修改配置文件
  4. 单击“Body”配置项,上传需要进行人脸检测的图片。
    图8 修改配置文件
  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
            }
          }
        }
      ]
    }

相关文档