人脸检测与五官定位

功能描述

人脸检测与五官定位能力可以检测图片中的人脸并给出每张人脸精准定位和105个关键点信息。输出人脸数量、人脸矩形坐标、人脸姿态、双瞳孔中心坐标、人脸置信度列表等信息，支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分，支持检测含有多张人脸的照片多种姿态角度判断。

应用场景

人脸关键点检测，是后续识别、分析和特效应用的基础。它为人脸识别、表情分析、疲劳检测、三维人脸重建、人脸美颜、换脸等人脸相关应用提供了人脸精确信息。

• 互动娱乐应用：支持人脸五官及轮廓精准定位，实现动态贴纸、小视频玩法、特效相机等互动娱乐功能。
• 人脸美颜拍摄：高精度人脸关键点可进行美颜塑形，落地在图片、视频、互动直播等多种美颜场景。
• 面部定位分析：支持人脸轮廓精准定位和面部关键点分析，落地在智能医美、智能APP等高价值场景。

特色优势

• 高精度定位：支持眉毛、眼睛、瞳孔、鼻子、嘴等五官位置的精准定位。
• 适应能力强：不同照片、人脸尺寸多场景下，适应最大90度侧脸、平面360旋转人脸等情景。
• 支持多人脸：支持单图检测多个人脸，应对人脸编辑、换脸、姿态矫正等高精度人脸定位场景。
• 图片质量打分：支持人脸遮挡、光照、模糊度、姿态、噪声综合质量评分。
• 平台服务稳定：提供在高并发，大流量下的毫秒级识别响应和保障。

接入指引

1. 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。

2. 开通能力：请确保您已开通人脸人体服务，若未开通服务请立即开通。

3. 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。

4. 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。

5. 开发接入步骤：

• 在SDK总览中选择您要接入使用的SDK语言。
• 在对应语言的SDK文档中找到AI类目为人脸人体（facebody）的SDK包进行安装。
• 参考文档中提供的示例代码进行适当修改后调用。

6. 示例代码：该能力常用语言的示例代码，请参见人脸检测与五官定位示例代码。

7. 客户端直接调用：该能力常用的客户端调用方式包括以下几种。

• Web前端直接调用
• 小程序场景下直接调用
• Android端直接调用
• iOS端直接调用

输入限制

• 图像格式：JPEG、JPG、PNG、BMP。
• 图像大小：不超过30 MB。
• 图像分辨率：大于32×32像素，小于8192×8192像素，人脸占比不低于64×64像素。
• URL地址中不能包含中文字符。

计费说明

关于人脸检测与五官定位的计费方式及报价，请参见计费介绍。

请求参数

返回数据

示意图

• 原图
• 105关键点示意图

SDK参考

阿里云视觉AI人脸人体类目下的人脸检测与五官定位能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为人脸人体（facebody）的SDK包，文件参数通过SDK调用可支持本地文件及任意URL，具体可参见SDK总览。

示例代码

该能力常用语言的示例代码，请参见人脸检测与五官定位示例代码。

示例

请求示例

http(s)://facebody.cn-shanghai.aliyuncs.com/?Action=DetectFace      //更多关于访问域名（Endpoint）信息，请参见：https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/facebody/DetectFace/DetectFace1.png
&Landmark=true
&Quality=true
&Pose=true
&MaxFaceNumber=1
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DetectFaceResponse>
    <RequestId>26B5334B-FD8A-5994-A1DA-3CA8F7B25676</RequestId>
    <Data>
        <FaceProbabilityList>0.96</FaceProbabilityList>
        <Pupils>417.83</Pupils>
        <Pupils>226.09</Pupils>
        <Pupils>8.15</Pupils>
        <Pupils>517.46</Pupils>
        <Pupils>231.53</Pupils>
        <Pupils>8.15</Pupils>
        <FaceRectangles>358</FaceRectangles>
        <FaceRectangles>141</FaceRectangles>
        <FaceRectangles>207</FaceRectangles>
        <FaceRectangles>255</FaceRectangles>
        <FaceCount>1</FaceCount>
        <PoseList>5.02</PoseList>
        <PoseList>-3.95</PoseList>
        <PoseList>2.41</PoseList>
        <Landmarks>381.1</Landmarks>
        <Landmarks>201.72</Landmarks>
        <Landmarks>448.09</Landmarks>
        <Landmarks>205.17</Landmarks>
        <Landmarks>415.19</Landmarks>
        <Landmarks>191.2</Landmarks>
        <Landmarks>415.28</Landmarks>
        <Landmarks>201.64</Landmarks>
        <Landmarks>391.35</Landmarks>
        <Landmarks>196.03</Landmarks>
        <Landmarks>403.15</Landmarks>
        <Landmarks>191.57</Landmarks>
        <Landmarks>426.94</Landmarks>
        <Landmarks>194.07</Landmarks>
        <Landmarks>438.42</Landmarks>
        <Landmarks>197.65</Landmarks>
        <LandmarkScore>95.89</LandmarkScore>
        <LandmarkCount>105</LandmarkCount>
        <Qualities>
            <ScoreList>99.92</ScoreList>
            <BlurList>99.21</BlurList>
            <FnfList>100</FnfList>
            <GlassList>100</GlassList>
            <IlluList>100</IlluList>
            <MaskList>99.53</MaskList>
            <NoiseList>99.74</NoiseList>
            <PoseList>100</PoseList>
        </Qualities>
    </Data>
</DetectFaceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "26B5334B-FD8A-5994-A1DA-3CA8F7B25676",
  "Data" : {
    "FaceProbabilityList" : [ 0.96 ],
    "Pupils" : [ 417.83, 226.09, 8.15, 517.46, 231.53, 8.15 ],
    "FaceRectangles" : [ 358, 141, 207, 255 ],
    "FaceCount" : 1,
    "PoseList" : [ 5.02, -3.95, 2.41 ],
    "Landmarks" : [ 381.1, 201.72, 448.09, 205.17, 415.19, 191.2, 415.28, 201.64, 391.35, 196.03, 403.15, 191.57, 426.94, 194.07, 438.42, 197.65 ],
    "LandmarkScore" : 95.89,
    "LandmarkCount" : 105,
    "Qualities" : {
      "ScoreList" : [ 99.92 ],
      "BlurList" : [ 99.21 ],
      "FnfList" : [ 100 ],
      "GlassList" : [ 100 ],
      "IlluList" : [ 100 ],
      "MaskList" : [ 99.53 ],
      "NoiseList" : [ 99.74 ],
      "PoseList" : [ 100 ]
    }
  }
}

错误码

关于人脸检测与五官定位的错误码，详情请参见常见错误码。

开源模型体验

更多开源免费模型体验及下载，详见魔搭社区：106点人脸关键点-通用领域-2D和全身关键点检测-通用领域-2D。

安全声明

• 请确保上传的图片或文件来源符合相应的法律法规。
• 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。
• 平台不存储用户在使用服务过程中涉及的原始人脸图片或文件信息。