文档

人脸检测

更新时间:

人脸检测功能基于图片AI技术,可以检测图片中的人脸以及人脸信息,如果图片中有多张人脸,系统会检测多张人脸以及人脸信息。通过人脸检测和其他技术共同使用,可以用于人脸识别、人脸认证、人脸表情分析等多种场景。

使用场景

  • 人脸识别:通过人脸检测和识别技术,检测人脸信息。然后将人脸与数据库中的人脸进行比对,实现身份验证、门禁控制等应用。

    说明

    人脸信息包括人脸ID、年龄、性别、心情、吸引力、人脸质量、人脸属性等,其中人脸属性包括人脸位置、头部朝向、眼镜、胡子、面罩等。

  • 人脸认证:通过人脸检测和认证技术,验证用户的身份,如手机解锁、支付验证等。

  • 人脸表情分析:通过人脸检测和表情识别技术,分析人脸表情,用于情感分析、人机交互、虚拟角色等应用。

注意事项

  • 人脸检测功能仅支持同步处理(x-oss-process处理方式)。

  • 使用人脸检测功能前,需要先绑定IMM Project。关于控制台和API如何绑定,请参见快速入门AttachOSSBucket

  • 不支持匿名访问。

  • 必须拥有IMM处理所需的相关权限。更多信息,请参见权限

参数说明

操作名称:image/faces

使用REST API

检测图片中的人脸信息

处理示例

GET /example.jpg?x-oss-process=image/faces HTTP/1.1
Host: image-demo.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 21 Jul 2023 08:57:30 GMT
Authorization: OSS qn6qrrqxo2oawuk53otf****:UNQDb7GapEgJkcde6OhZ9J****

返回示例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 21 Jul 2023 08:57:30 GMT
Content-Type: application/json;charset=utf-8
Content-Length: 161
Connection: keep-alive
x-oss-request-id: 628E2481184E20F26C000009
x-oss-transfer-acc-type: acc-none
x-oss-data-location: oss-cn-hangzhou-a
ETag: "D0F162350DA037F4DC2A142B2E116BD0"
Last-Modified: Wed, 25 May 2022 12:20:34 GMT
x-oss-object-type: Normal
x-oss-hash-crc64ecma: 2040549661341440100
x-oss-storage-class: Standard
x-oss-server-time: 12437

{
    "RequestId": "5F2389FE-A5E3-076F-B071-43A33DB0D716",
    "Figures": [{
        "Beard": "none",
        "MaskConfidence": 0.7509999871253967,
        "Gender": "male",
        "Boundary": {
            "Left": 280,
            "Top": 36,
            "Height": 87,
            "Width": 70
        },
        "BeardConfidence": 0.9980000257492065,
        "FigureId": "d39651db-9dc4-469f-8834-d2fcf30e179e",
        "Mouth": "open",
        "Emotion": "none",
        "Age": 12,
        "MouthConfidence": 0.5669999718666077,
        "FigureType": "face",
        "GenderConfidence": 0.9509999752044678,
        "HeadPose": {
            "Pitch": -12.309000015258789,
            "Roll": -11.362000465393066,
            "Yaw": 3.443000078201294
        },
        "Mask": "none",
        "EmotionConfidence": 0.9950000047683716,
        "HatConfidence": 0.9879999756813049,
        "GlassesConfidence": 1,
        "Sharpness": 0.8870000243186951,
        "FigureClusterId": "figure-cluster-id-unavailable",
        "FaceQuality": 0.8289999961853027,
        "Attractive": 0.12099999934434891,
        "AgeSD": 5,
        "Glasses": "none",
        "FigureConfidence": 0.9990000128746033,
        "Hat": "hat"
    }
    ]
}

使用SDK

人脸检测仅支持同步处理,SDK使用方法请参见使用SDK

  • 本页导读 (1)
文档反馈