对象存储BOS

    人脸探测(face)

    功能描述

    • 检测请求图片中的人脸,返回人脸位置、72 个关键点坐标、及人脸相关属性信息。
    • 检测响应速度,与图片中人脸数量相关,人脸数量较多时响应时间会有些许延长。
    • 典型应用场景:如人脸属性分析基于人脸关键点的加工分析人脸营销活动等。
    • 五官位置会标记具体坐标;72 个关键点坐标也包含具体坐标,但不包含对应位置的详细位置描述。

    请求参数

    返回参数

    参数 类型 是否必须 说明
    log_id uint64 日志 id
    result_num uint32 人脸数目
    result object[] 人脸属性对象的集合
    +age double 年龄。face_fields 包含 age 时返回
    +beauty double 美丑打分,范围 0-100,越大表示越美。face_fields 包含 beauty 时返回
    +location object 人脸在图片中的位置
    ++left uint32 人脸区域离左边界的距离
    ++top uint32 人脸区域离上边界的距离
    ++width uint32 人脸区域的宽度
    ++height uint32 人脸区域的高度
    +face_probability double 人脸置信度,范围 0-1
    +rotation_angle int32 人脸框相对于竖直方向的顺时针旋转角,[-180,180]
    +yaw double 三维旋转之左右旋转角 [-90(左), 90(右)]
    +pitch double 三维旋转之俯仰角度 [-90(上), 90(下)]
    +roll double 平面内旋转角 [-180(逆时针), 180(顺时针)]
    +expression uint32 表情,0,不笑;1,微笑;2,大笑。face_fields包含expression时返回
    +expression_probability double 表情置信度,范围 0~1。face_fields 包含expression时返回
    +faceshape object[] 脸型置信度。face_fields 包含 faceshape 时返回
    ++type string 脸型:square/triangle/oval/heart/round
    ++probability double 置信度:0~1
    +gender string male、female。face_fields 包含 gender时返回
    +gender_probability double 性别置信度,范围 0~1。face_fields 包含gender时返回
    +glasses uint32 是否带眼镜,0-无眼镜,1-普通眼镜,2-墨镜。face_fields包含glasses时返回
    +glasses_probability double 眼镜置信度,范围 0~1。face_fields包含glasses时返回
    +landmark object[] 4 个关键点位置,左眼中心、右眼中心、鼻尖、嘴中心。face_fields包含landmark时返回
    ++x uint32 x坐标
    ++y uint32 y坐标
    +landmark72 object[] 72个特征点位置,示例图 。face_fields包含landmark时返回
    ++x uint32 x坐标
    ++y uint32 y坐标
    +race string yellow、white、black、arabs。face_fields包含race时返回
    +race_probability double 人种置信度,范围 0~1。face_fields包含race时返回
    +qualities object 人脸质量信息。face_fields 包含qualities时返回
    ++occlusion object 人脸各部分遮挡的概率, [0, 1] (待上线)
    +++left_eye double 左眼
    +++right_eye double 右眼
    +++nose double 鼻子
    +++mouth double
    +++left_cheek double 左脸颊
    +++right_cheek double 右脸颊
    +++chin double 下巴
    ++blur double 人脸模糊程度,[0, 1]。0表示清晰,1表示模糊(待上线)
    ++illumination - 取值范围在[0,255],表示脸部区域的光照程度(待上线)
    ++completeness - 人脸完整度,[0, 1]。0表示完整,1表示不完整(待上线)
    ++type object 真实人脸/卡通人脸置信度
    +++human - 真实人脸置信度,[0, 1]
    +++cartoon - 卡通人脸置信度,[0, 1]

    返回示例

    {
        "result_num": 1,
        "result": [
            {
                "location": {
                    "left": 90,
                    "top": 92,
                    "width": 111,
                    "height": 99
                },
                "face_probability": 1,
                "rotation_angle": 6,
                "yaw": 11.61234664917,
                "pitch": -0.30852827429771,
                "roll": 8.8044967651367,
                "landmark": [
                    {
                        "x": 105,
                        "y": 110
                    },
                  ...
                ],
                "landmark72": [
                    {
                        "x": 88,
                        "y": 109
                    },
                   ...
                ],
                "gender": "male",
                "gender_probability": 0.99358034133911,
                "glasses": 0,
                "glasses_probability": 0.99991309642792,
                "race": "yellow",
                "race_probability": 0.99960690736771,
                "qualities": {
                    "occlusion": {
                        "left_eye": 0.000085282314103097,
                        "right_eye": 0.00001094374601962,
                        "nose": 3.2677664307812e-7,
                        "mouth": 2.6582130940866e-10,
                        "left_cheek": 8.752236624332e-8,
                        "right_cheek": 1.0212766454742e-7,
                        "chin": 4.2632994357028e-10
                    },
                    "blur": 4.5613666312237e-41,
                    "illumination": 0,
                    "completeness": 0,
                    "type": {
                        "human": 0.98398965597153,
                        "cartoon": 0.016010366380215
                    }
                }
            }
        ],
        "log_id": 2418894422
    }  
    上一篇
    通用文字识别(ocr)
    下一篇
    色情识别(antiporn)