场景能力描述

基于人脸记录和识别结果,对于二次到访人员进行提示,可作为下一步业务处理的参考信息。

输入限制

  • 图片格式: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": "liveness"
            }
          ],
          "ImageURL": "https://viapi-test.oss-cn-shanghai.aliyuncs.com/demo-center/facebody/DetectLivingFace.jpg"
        }
      ]
    }
  4. 根据返回参数Label的值,判断是否为liveness。如果是,继续执行下一步;如果否,操作结束。
  5. 调用搜索人脸(SearchFace),请求参数ImageURLDbName,分别对应待测图片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小时后会被系统自动清理删除。