场景能力描述

可检测来访人员是否是陌生人，代替传统的刷卡、人工登记等方法，记录临时出入人员信息，降低安全管理风险，可适用于园区、厂区、小区、景区等。

输入限制

  • 图片格式：JPEG、JPG、PNG。
  • 图像大小：图像大小不超过5M。
  • 图像分辨率：分辨率大于5×5像素，小于4096×4096像素，人脸的尺寸建议大于64×64像素。
  • URL地址中不能包含空格及中文字符。

调用能力

人脸检测与五官定位（DetectFace）、人脸活体检测（DetectLivingFace）和人脸搜索（SearchFace）

使用说明

目前场景能力未能通过API的方式进行对外公开，您可以根据以下操作步骤进行自行搭建，完成场景能力的调用。

操作步骤

  1. 调用人脸检测与五官定位（DetectFace），请求参数ImageURL对应待测图片URL地址，得到返回参数FaceCount。
  2. 根据返回参数FaceCount的值进行判断。
    • 如果FaceCount的值大于0，即判断为有人脸，继续执行下一步。
    • 如果FaceCount的值等于0，即判断为无人脸，操作结束。
  3. 调用人脸活体检测（DetectLivingFace），请求参数ImageURL对应待测图片URL地址，返回参数代码示例如下所示。
    "Data": {
  "Elements": [
    {
      "TaskId": "img6xmr38ZM4aU6SYeCmj6SAp-1tde$O",
      "Results": [
        {
          "Suggestion": "review",
          "Rate": 76.51,
          "Label": "normal"
        }
      ],
      "ImageURL": "https://viapi-test.oss-cn-shanghai.aliyuncs.com/demo-center/facebody/DetectLivingFace.jpg"
    }
  ]
}
  4. 根据返回参数Label的值，判断是否为normal。如果是，继续执行下一步；如果否，操作结束。
  5. 调用人脸搜索（SearchFace），请求参数ImageURL和DbName，分别对应待测图片URL地址和对应的人脸库名称，返回数据，流程调用结束。返回参数代码示例如下所示。
    "Data": {
  "MatchList": [
    {
      "FaceItems": [
        {
          "FaceId": "1595402916226000",
          "EntityId": "defaultFace_6",
          "Score": "0.8766200864727681",
          "ExtraData": "人物6"
        }
      ],
      "Location": {
        "X": 243,
        "Y": 71,
        "Height": 170,
        "Width": 132
      }
    }
  ]
}
  6. 根据返回参数中的score字段进行过滤，取score值大于0.4，且在所有结果取值最大的那条数据作为匹配上的结果。

错误码

关于人脸检测定位、人脸活体检测和搜索人脸的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。