人脸属性识别教程_快速入门_阿里云视觉智能开放平台-阿里云

背景信息

人脸人体识别技术是基于阿里云深度学习算法，结合图像或视频的人脸检测、分析、比对以及人体检测等技术，为您提供人脸人体的检测定位、人脸属性识别和人脸比对等能力。可以为开发者和企业提供高性能的在线API服务，应用于人脸AR、人脸识别和认证、大规模人脸检索、照片管理等各种场景。

开通服务

首先，您需要开通人脸人体服务，然后才能调用人脸口罩检测的API。其次，在进行人脸识别时，我们需要先将图片上传至上海地域的OSS Bucket中生成URL链接，然后通过图片URL链接传入图片数据。关于如何开通OSS服务请参见开通OSS服务。下面为您介绍如何开通人脸人体服务。

登录阿里云视觉智能开放平台。
在顶部菜单栏的能力广场中单击人脸人体。
在人脸人体页面中单击免费使用。
确认开通地域后单击立即购买。
在确认订单步骤中勾选我已阅读并同意人脸人体服务协议后单击去支付。
页面提示服务开通成功。
说明
- 当前平台还在公测阶段，所有服务均可以免费使用。
- 开通了人脸人体服务后，该服务下的所有API均可以直接调用，不需要再单独开通。

生成URL

例如我们需要对下图进行人脸识别检测。

登录OSS管理控制台。
创建存储空间。
创建Bucket选择区域时，需要选择与人脸人体服务能力相同的区域华东2（上海）。

说明如果您的OSS所在地域不是华东2（上海），那么请参见非上海地域OSS用户生成URL。
将上述示例图片上传到OSS服务。
具体操作请参见上传文件。

查看图片URL。

在已上传图片列表中，单击详情查看并复制图片URL。

http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E4%BA%BA%E8%84%B8%E5%B1%9E%E6%80%A7%E8%AF%86%E5%88%AB.jpg

添加依赖包

请根据您的代码选择添加不同的依赖包。

Java

在您的Java项目中添加人脸人体能力的POM依赖。

<!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-facebody -->
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-facebody</artifactId>
    <version>1.1.0</version>
</dependency>

Python
执行如下命令安装Python SDK。
```
pip install aliyun-python-sdk-facebody
```

Node.js

使用NPM安装Node.js SDK。

npm install @alicloud/facebody20191230@1.2.1 --save

PHP

使用composer工具安装PHP SDK。

composer require alibabacloud/facebody-20191230

代码示例

请求示例如下：

Java请求示例

说明请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.google.gson.Gson;
import java.util.*;
import com.aliyuncs.facebody.model.v20191230.*;

public class RecognizeFace {

    public static void main(String[] args) {
        DefaultProfile profile = DefaultProfile.getProfile("cn-shanghai", "<accessKeyId>", "<accessSecret>");
        IAcsClient client = new DefaultAcsClient(profile);

        RecognizeFaceRequest request = new RecognizeFaceRequest();
        request.setRegionId("cn-shanghai");
        request.setImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E4%BA%BA%E8%84%B8%E5%B1%9E%E6%80%A7%E8%AF%86%E5%88%AB.jpg");

        try {
            RecognizeFaceResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }

    }
}

Python请求示例

说明请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。

#!/usr/bin/env python
#coding=utf-8

from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdkfacebody.request.v20191230.RecognizeFaceRequest import RecognizeFaceRequest

client = AcsClient('<accessKeyId>', '<accessSecret>', 'cn-shanghai')

request = RecognizeFaceRequest()
request.set_accept_format('json')

request.set_ImageURL("http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E4%BA%BA%E8%84%B8%E5%B1%9E%E6%80%A7%E8%AF%86%E5%88%AB.jpg")

response = client.do_action_with_exception(request)
# python2:  print(response)
print(str(response, encoding='utf-8'))

Node.js请求示例

说明请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。

const Core = require('@alicloud/pop-core');

var client = new Core({
  accessKeyId: '<accessKeyId>',
  accessKeySecret: '<accessSecret>',
  endpoint: 'https://facebody.cn-shanghai.aliyuncs.com',
  apiVersion: '2019-12-30'
});

var params = {
  "RegionId": "cn-shanghai",
  "ImageURL": "http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E4%BA%BA%E8%84%B8%E5%B1%9E%E6%80%A7%E8%AF%86%E5%88%AB.jpg"
}

var requestOption = {
  method: 'POST'
};

client.request('RecognizeFace', params, requestOption).then((result) => {
  console.log(JSON.stringify(result));
}, (ex) => {
  console.log(ex);
})

PHP请求示例

说明请将如下代码示例中的<accessKeyId>和<accessSecret>替换为您的真实AK信息。如何获取AK请参见创建AccessKey。

<?php
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;

// Download：https://github.com/aliyun/openapi-sdk-php
// Usage：https://github.com/aliyun/openapi-sdk-php/blob/master/README.md

AlibabaCloud::accessKeyClient('<accessKeyId>', '<accessSecret>')
                        ->regionId('cn-shanghai')
                        ->asDefaultClient();

try {
    $result = AlibabaCloud::rpc()
                          ->product('facebody')
                          // ->scheme('https') // https | http
                          ->version('2019-12-30')
                          ->action('RecognizeFace')
                          ->method('POST')
                          ->host('facebody.cn-shanghai.aliyuncs.com')
                          ->options([
                                        'query' => [
                                          'RegionId' => "cn-shanghai",
                                          'ImageURL' => "http://viapi-test.oss-cn-shanghai.aliyuncs.com/sanjiye-meizi/%E4%BA%BA%E8%84%B8%E5%B1%9E%E6%80%A7%E8%AF%86%E5%88%AB.jpg",
                                        ],
                                    ])
                          ->request();
    print_r($result->toArray());
} catch (ClientException $e) {
    echo $e->getErrorMessage() . PHP_EOL;
} catch (ServerException $e) {
    echo $e->getErrorMessage() . PHP_EOL;
}

结果示例

该接口的请求结果示例如下。

{
    "RequestId": "B0760ABB-F70C-4B00-B9FF-4BD553B4233E",
    "Data": {
        "FaceRectangles": [
            215,
            57,
            172,
            229
        ],
        "DenseFeatureLength": 1024,
        "PoseList": [
            "-15.702389717102051",
            "8.4830875396728516",
            "0.080579757690429688"
        ],
        "Pupils": [
            "243.02786254882812",
            "149.0238037109375",
            "7.3701672554016113",
            "315.86138916015625",
            "140.451416015625",
            "7.3701672554016113"
        ],
        "GenderList": [
            1
        ],
        "DenseFeatures": [
            "-0.037511065602302551",
            "0.022202443331480026",
            "0.079755261540412903",
            "-0.007559098768979311",
            "0.032428193837404251",
            "-0.031667508184909821",
            "-0.017420554533600807",
            "-0.000207205128390342",
            "-0.014593920670449734",
            "-0.0037230239249765873",
            "0.013444140553474426",
            "0.082390092313289642",
            "0.013446067459881306",
            "-0.0037146448157727718",
            "-0.0077681485563516617",
            "0.054059881716966629",
            "0.030584953725337982",
            "0.051545839756727219",
            "0.025875747203826904",
            "-0.0015580562176182866",
            "...",
            "0.0072302431799471378",
            "-0.0027828323654830456",
            "-0.021698996424674988",
            "-0.022436553612351418",
            "0.019861612468957901"
        ],
        "FaceProbabilityList": [
            1
        ],
        "LandmarkCount": 105,
        "AgeList": [
            55
        ],
        "Glasses": [
            1
        ],
        "Landmarks": [
            "213.98641967773438",
            "145.24307250976562",
            263.90673828125,
            "135.84013366699219",
            "237.13218688964844",
            "127.43693542480469",
            "238.47280883789062",
            "137.8927001953125",
            "218.65261840820312",
            "136.04519653320312",
            "227.24664306640625",
            "130.36431884765625",
            247.36865234375,
            "126.25999450683594",
            "257.45843505859375",
            "128.07203674316406",
            "222.02139282226562",
            "142.34713745117188",
            "230.11050415039062",
            "139.60614013671875",
            "246.92530822753906",
            "136.674072265625",
            "255.44786071777344",
            "136.97525024414062",
            "291.1983642578125",
            "134.10868835449219",
            "344.8785400390625",
            "138.02426147460938",
            "318.74273681640625",
            "...",
            "243.86373901367188",
            "265.70501708984375",
            "324.709716796875",
            "277.518798828125"
        ],
        "Expressions": [
            0
        ],
        "FaceCount": 1
    }
}

从返回结果中得到该图片的人脸属性信息结果如下。

人脸个数：1
性别：男性
年龄：55
人脸表情：中性
是否戴眼镜：有眼镜