跳到主要内容

人脸关键点检测（68 关键点）

1. 任务简介​

1.1 任务 ID​

638847d2c450c8f97e8d4399

提示

任务 ID 全局固定且不变，建议客户将其定义为代码常量。

1.2 能力介绍​

该任务可对图像中的人脸进行检测，返回人脸的 68 个关键点坐标、人脸角度、遮挡率、人脸框坐标与置信度等信息。相比人脸检测，该任务返回的信息更丰富，可用于人脸对齐、人脸跟踪等应用。

2. 请求参数​

图片接口公共请求参数详见：图片同步识别接口，图片异步识别接口。

视频接口公共请求参数详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口。

3. 返回结果​

3.1 公共返回结果​

图片接口公共返回结果详见：图片同步识别接口，图片异步识别接口。

视频接口公共返回结果详见：视频同步识别接口，视频文件异步识别接口，视频流异步识别接口。

3.2 任务返回结果 🎯​

任务结果​

参数名称类型是否必需说明
fileListArray是每张图片的识别结果

FileResult 参数说明​

参数名称类型是否必需说明
nameString是如果上传的 image 参数是 url ，则该值是图片 url ；如果是以图片文件上传，则该值为文件名
objectsArray是检测出来的所有物体

Objects 参数​

参数名称类型是否必需说明
locationArray是物体方框坐标以图片左上角为原点，分别是 [左上角坐标, 右上角坐标, 右下角坐标, 左下角坐标]，坐标值是相对于图片大小的百分比形式
scoresFloat是物体类别分数，准确度 [0, 1]，值越高机器对判定结果越有把握
categoryInt否物体类别，详见 任务返回标签说明
pointsArray是人脸关键点坐标数组，包含 68 个关键点；每个关键点为对象 {x, y, vis}，x、y 为相对坐标（相对于图片大小的百分比），vis 为可见性，取值范围 [0, 1]（0 表示不可见，1 表示可见）
pitchFloat是人脸俯仰角度，范围 [-90, 90]，0 表示水平，正值表示抬头，负值表示低头
yawFloat是人脸偏航角度，范围 [-180, 180]，0 表示正前方，正值表示向右（东）偏转，负值表示向左（西）偏转
rollFloat是人脸横滚角度，范围 [-90, 90]，0 表示水平，正值表示向左转，负值表示向右转
occlusionRateFloat是人脸遮挡率，范围 [0, 1]，0 表示完全可见，1 表示完全遮挡

3.3 任务返回标签说明 🎯🎯​

category 值说明
0人脸

3.4 任务结果示例​

{
  "638847d2c450c8f97e8d4399": {
    "fileList": [
      {
        "name": "<url>",
        "objects": [
          {
            "location": [
              [0.7007799905443949, 0.26091899871826174],
              [0.8222528366815476, 0.26091899871826174],
              [0.8222528366815476, 0.5064324118874289],
              [0.7007799905443949, 0.5064324118874289]
            ],
            "category": 0,
            "scores": 0.99,
            "points": [
              { "x": 0.735, "y": 0.312, "vis": 1 },
              { "x": 0.752, "y": 0.328, "vis": 0.96 },
              { "x": 0.768, "y": 0.345, "vis": 0.94 }
            ],
            "pitch": 5.2,
            "yaw": -12.3,
            "roll": 1.0,
            "occlusionRate": 0.12
          }
        ]
      }
    ]
  }
}