所有文档

          对象存储 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)