该功能基于图片 AI 技术实现，能够检测图片中的人脸 矩形框 和 属性，如果图片有多张人脸，会把多张人脸的矩形框和属性检测出来。基于这些元数据，应用可以做年龄、性别的统计。

参数

操作名称：imm/detecface

结果字段意义参考 数据类型 。

返回内容示例：

{
    "Faces":[
        {
            "Age":29,
            "Attractive":0.95,
            "Emotion":"HAPPY",
            "EmotionConfidence":0.9875330924987793,
            "EmotionDetails":{
                "ANGRY":0.000016857109585544094,
                "CALM":0.012278525158762932,
                "DISGUSTED":0.000012325451280048583,
                "HAPPY":0.9875330924987793,
                "SAD":0.0000388074986403808,
                "SCARED":0.000006888585176056949,
                "SURPRISED":0.000054363932576961815
            },
            "FaceAttributes":{
                "Beard":"NONE",
                "BeardConfidence":1,
                "FaceBoundary":{
                    "Height":928,
                    "Left":607,
                    "Top":628,
                    "Width":894
                },
                "Glasses":"NONE",
                "GlassesConfidence":1,
                "Mask":"NONE",
                "MaskConfidence":0.9999999403953552,
                "Race":"YELLOW",
                "RaceConfidence":0.598323404788971
            },
            "FaceConfidence":0.9704222083091736,
            "FaceId":"4199e1985b6d3bb075f0994c82e6d2fd82a274c11ce183e1fdb222dd3aa8c7ce",
            "Gender":"MALE",
            "GenderConfidence":1,
        }
    ],
    "ImageUri":"oss://image-demo/person.jpg",
    "RequestId":"5C3D854A3243A93A275E9C99",
    "httpStatusCode":200,
    "success":true
}

使用示例

假如请求 Bucket 是 imm-demo，该 Bucket 区域在 华东1，对应的域名是 oss-cn-hangzhou.aliyuncs.com，请求预览照片是 person.jpg，未签名的请求结构如下：

http://image-demo.oss-cn-hangzhou.aliyuncs.com/person.jpg?x-oss-process=imm/detecface

这里通过 Python SDK 实现接口调用如下：

bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name)
key = 'person.jpg'
process = "imm/detecface" //进行图片人脸检测
bucket.get_object(key, process=process)