TP5 结合百度 AI 人脸识别技术教程

百度AI开放平台：http://ai.baidu.com/

百度API文档-v3-人脸检测：https://ai.baidu.com/docs#/Face-Detect-V3/top

人脸识别接口分为V2和V3两个版本，本文档为V3版本接口的说明文档，请确认您在百度云后台获得的是V3版本接口权限

辨别接口版本的方法是：在百度云后台进入【应用列表】，点击【应用名称】，在【API列表】中可以看到【请求地址】，若请求地址中带有【v3】标识，则您具有的是v3权限；若请求地址中带有【v2】标识，则您具有的是v2权限

能力介绍

接口能力

● 人脸检测：检测图片中的人脸并标记出位置信息;

● 人脸关键点：展示人脸的核心关键点信息，及150个关键点信息。

● 人脸属性值：展示人脸属性信息，如年龄、性别等。

● 人脸质量信息：返回人脸各部分的遮挡、光照、模糊、完整度、置信度等信息。

业务应用

典型应用场景：如人脸属性分析，基于人脸关键点的加工分析，人脸营销活动等。

鉴权认证机制

针对HTTP API调用者，百度AIP开放平台使用OAuth2.0授权调用开放API，调用API时必须在URL中带上accesss_token参数，获取Access Token的流程如下：

获取Access Token

请求URL数据格式

向授权服务地址https://aip.baidubce.com/oauth/2.0/token发送请求（推荐使用POST），并在URL中带上以下参数：

● grant_type： 必须参数，固定为client_credentials；

● client_id： 必须参数，应用的API Key；

● client_secret： 必须参数，应用的Secret Key；

例如：

<?php
function request_post($url = '', $param = '') {
        if (empty($url) || empty($param)) {
            return false;
        }
        
        $postUrl = $url;
        $curlPost = $param;
        $curl = curl_init();//初始化curl
        curl_setopt($curl, CURLOPT_URL,$postUrl);//抓取指定网页
        curl_setopt($curl, CURLOPT_HEADER, 0);//设置header
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);//要求结果为字符串且输出到屏幕上
        curl_setopt($curl, CURLOPT_POST, 1);//post提交方式
        curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);
        $data = curl_exec($curl);//运行curl
        curl_close($curl);
        
        return $data;
    }

	$url = 'https://aip.baidubce.com/oauth/2.0/token';
    $post_data['grant_type']       = 'client_credentials';
    $post_data['client_id']      = '你的 Api Key';
    $post_data['client_secret'] = '你的 Secret Key';
    $o = "";
    foreach ( $post_data as $k => $v ) 
    {
    	$o.= "$k=" . urlencode( $v ). "&" ;
    }
    $post_data = substr($o,0,-1);
    
    $res = request_post($url, $post_data);

    var_dump($res);

?>

● 服务器返回的JSON文本参数如下：

● access_token： 要获取的Access Token；

● expires_in： Access Token的有效期(秒为单位，一般为1个月)；

其他参数忽略，暂时不用;

例如：

{
  "refresh_token": "25.b55fe1d287227ca97aab219bb249b8ab.315360000.1798284651.282335-8574074",
  "expires_in": 2592000,
  "scope": "public wise_adapt",
  "session_key": "9mzdDZXu3dENdFZQurfg0Vz8slgSgvvOAUebNFzyzcpQ5EnbxbF+hfG9DQkpUVQdh4p6HbQcAiz5RmuBAja1JJGgIdJI",
  "access_token": "24.6c5e1ff107f0e8bcef8c46d3424a0e78.2592000.1485516651.282335-8574074",
  "session_secret": "dfac94a3489fe9fca7c3221cbf7525ff"
}

若请求错误，服务器将返回的JSON文本包含以下参数：

● error： 错误码；关于错误码的详细信息请参考下方鉴权认证错误码。

● error_description： 错误描述信息，帮助理解和解决发生的错误。

例如认证失败返回：

{
    "error": "invalid_client",
    "error_description": "unknown client id"
}

鉴权认证错误码

● errorerror_description解释

● invalid_clientunknown client idAPI Key不正确

● invalid_clientClient authentication failedSecret Key不正确

获取 access_token 后,使用HTTPS POST发送：

https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=24.f9ba9c5341b67688ab5added8bc91dec.2592000.1485570332.282335-8574074

请求说明

注意事项：

● 请求体格式化：Content-Type为application/json，通过json格式化请求体。

● Base64编码：请求的图片需经过Base64编码，图片的base64编码指将图片数据编码成一串字符串，使用该字符串代替图像地址。您可以首先得到图片的二进制，然后用Base64格式编码即可。需要注意的是，图片的base64编码是不包含图片头的，如data:image/jpg;base64,

● 图片格式：现支持PNG、JPG、JPEG、BMP，不支持GIF图片

● 人脸识别接口分为V2和V3两个版本

请求示例

HTTP方法：POST

请求URL： https://aip.baidubce.com/rest/2.0/face/v3/detect

URL参数：

Header：

Body中放置请求参数，参数详情如下：

请求参数

说明：face_field参数，默认只返回人脸框、概率和旋转角度，age等更多属性，请在此参数中添加。

请求示例代码

提示一：使用示例代码前，请记得替换其中的示例Token、图片地址或Base64信息。

提示二：部分语言依赖的类或库，请在代码注释中查看下载地址。

PHP代码：

<?php
/**
 * 发起http post请求(REST API), 并获取REST请求的结果
 * @param string $url
 * @param string $param
 * @return - http response body if succeeds, else false.
 */
function request_post($url = '', $param = '')
{
    if (empty($url) || empty($param)) {
        return false;
    }

    $postUrl = $url;
    $curlPost = $param;
    // 初始化curl
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $postUrl);
    curl_setopt($curl, CURLOPT_HEADER, 0);
    // 要求结果为字符串且输出到屏幕上
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
    // post提交方式
    curl_setopt($curl, CURLOPT_POST, 1);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);
    // 运行curl
    $data = curl_exec($curl);
    curl_close($curl);

    return $data;
}

$token = '[调用鉴权接口获取的token]';
$url = 'https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=' . $token;
$bodys = "{\"image\":\"027d8308a2ec665acb1bdf63e513bcb9\",\"image_type\":\"FACE_TOKEN\",\"face_field\":\"faceshape,facetype\"}"
$res = request_post($url, $bodys);

var_dump($res);

说明

● 返回参数

• 返回结果

● 返回示例

{	
  "face_num": 1,
  "face_list": [
        {
            "face_token": "35235asfas21421fakghktyfdgh68bio",
            "location": { 
                "left": 117,
                "top": 131,
                "width": 172,
                "height": 170,
                "rotation": 4
            },
            "face_probability": 1,
            "angle" :{
                 "yaw" : -0.34859421849251
                 "pitch" 1.9135693311691  
                 "roll" :2.3033397197723  
            }
            "landmark": [  
                {
                    "x": 161.74819946289,
                    "y": 163.30244445801
                },
                ...
            ],
            "landmark72": [ 
                {
                    "x": 115.86531066895,
                    "y": 170.0546875
                }，
                ...
            ],
            "age": 29.298097610474,
            "beauty": 55.128883361816,
            "expression": {
                "type": "smile",
                "probability" : 0.5543018579483
            },
            "gender": {
                "type": "male",
                "probability": 0.99979132413864
            },
            "glasses": {
    			"type": "sun",
                "probability": 0.99999964237213
            },
            "race": {
                "type": "yellow",
                "probability": 0.99999976158142
            },
            "face_shape": {
                "type": "triangle",
                "probability": 0.5543018579483
            }
            "quality": {
                "occlusion": {
                    "left_eye": 0,
                    "right_eye": 0,
                    "nose": 0,
                    "mouth": 0,
                    "left_cheek": 0.0064102564938366,
                    "right_cheek": 0.0057411273010075,
                    "chin": 0
                },
                "blur": 1.1886881756684e-10,
                "illumination": 141,
                "completeness": 1
            }
        }
    ]
}

72个关键点分布图（对应landmark72个点的顺序，序号从0-71）：

150个关键点分布图，红色关键点为在72关键点基础上增加的关键点（对应landmark150个点的顺序，序号从0-149，且每个关键点有对应的英文命名作为参数名，请参考图片下方表格）：

关键点名称如下图，

tp5 + 百度AI人脸识别示例代码：

// AI人工智能
    public function getAIimg(){
        $file = request()->file('urlimg');
        $info = $file->move(ROOT_PATH . 'public' . DS . 'static/uploads/AI');
        if($info){
           $img=ROOT_PATH.'/public/static/uploads/AI/'.date('Ymd').'/'.$info->getFilename();
           $image = \think\Image::open(ROOT_PATH.'/public/static/uploads/AI/'.date('Ymd').'/'.$info->getFilename());
            // 按照原图的比例生成一个最大为150*150的缩略图并保存为thumb.png
           $image->thumb(300, 300)->save(ROOT_PATH.'/public/static/uploads/AI/'.date('Ymd').'/'.$info->getFilename());
            // $img=ROOT_PATH.'/public/static/uploads/AI/20190612/d866f443451579cbd1d5da557348b4f2.jpg';
           $url = 'https://aip.baidubce.com/oauth/2.0/token';
            $post_data['grant_type'] = 'client_credentials';
            $post_data['client_id'] = 'client_id';
            $post_data['client_secret'] = 'client_secret';
            $o = "";
            foreach ( $post_data as $k => $v ) 
            {
                $o.= "$k=" . urlencode( $v ). "&" ;
            }
            $post_data = substr($o,0,-1);
            
            $res =$this->request_post($url, $post_data);
            $jsonarr = json_decode($res, true);
            $token=$jsonarr['access_token'];
            $token = $token;

            $url = 'https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=' . $token;
            $param = array(
              'image' => $this->base64EncodeImage($img),
              'image_type' => 'BASE64',
              'face_field' => 'age,beauty,expression,gender,emotion,quality,glasses,face_shape'
              // 'face_field' => 'age,beauty,expression,face_shape,gender,glasses,landmark,landmark150,race,quality,eye_status,emotion,face_type'
             );
             $param = json_encode($param);
             $res =$this->request_post($url, $param);
             $result = json_decode($res, true);
             if($result['error_code'] != 0){
                 return json(['msg'=>'失败','code'=>'700','message'=>'上传的人脸不符合要求，请重新上传五官清晰的真实头像']);
                 die;
             }
             $quality = $result['result']['face_list'][0]['age'];  //年龄 
             // $beauty = $result['result']['face_list'][0]['beauty'];
             $beauty = round($result['result']['face_list'][0]['beauty']); //美丑打分，范围0-100，越大表示越美
             $expression = $result['result']['face_list'][0]['expression']['type'];   //表情none:不笑；smile:微笑；laugh:大笑
             $gender = $result['result']['face_list'][0]['gender']['type'];// 性别 male:男性 female:女性
             $emotion = $result['result']['face_list'][0]['emotion']['type'];  //情绪 angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无情绪
             $glasses = $result['result']['face_list'][0]['glasses']['type'];   //是否带眼镜，face_field包含,glasses时返回none:无眼镜，common:普通眼镜，sun:墨镜
             $face_shape = $result['result']['face_list'][0]['face_shape']['type'];   //脸型，当face_field包含face_shape时返回,square: 正方形 triangle:三角形 oval: 椭圆 heart: 心形 round: 圆形
            $sex =$gender=='male'?'男':'女';
            if($emotion=='angry'){
                $emotion='愤怒'; 
            }else if ($emotion=='disgust') {
                $emotion='厌恶';
            }else if ($emotion=='fear') {
                $emotion='恐惧';
            }else if ($emotion=='happy') {
                $emotion='高兴';
            }else if ($emotion=='sad') {
                $emotion='伤心';
            }else if ($emotion=='surprise') {
                $emotion='惊讶';
            }else{
                $emotion='无情绪';
            }

            if($expression=='none'){
                $expression='不笑'; 
            }else if ($emotion=='smile') {
                $expression='微笑';
            }else{
                $expression='大笑';
            }
            if($glasses=='none'){
                $glasses='无眼镜'; 
            }else if ($glasses=='common') {
                $glasses='普通眼镜';
            }else{
                $glasses='墨镜';
            }
            if($face_shape=='square'){
                $face_shape='正方形'; 
            }else if ($face_shape=='triangle') {
                $face_shape='三角形';
            }else if ($face_shape=='oval') {
                $face_shape='椭圆';
            }else if ($face_shape=='heart') {
                $face_shape='心形';
            }else{
                $face_shape='圆形';
            }


            $re_data['img']='/public/static/uploads/AI/'.date('Ymd').'/'.$info->getFilename();
            $re_data['result']='年龄：'.$quality.'<br>'.'美丑打分：'.$beauty.'<br>'.'表情：'.$expression.'<br>'.'性别：'.$sex.'<br>'.'情绪：'.$emotion.'<br>'.'眼镜：'.$glasses.'<br>'.'脸型：'.$face_shape;
            $re_data['addtime']=time();
            $re_data['nick_name']=input('nickName');
            $re= db('minwx_ai')->insert($re_data);
            $re_dum=array(
                'sex'=>$sex,  //性别
                'quality'=>$quality,    //年龄
                'beauty'=>$beauty,     //美丑打分
                'expression'=>$expression,     //表情
                'emotion'=>$emotion,     //情绪
                'glasses'=>$glasses,     //眼镜
                'face_shape'=>$face_shape,     //脸型
                'img'=>'/public/static/uploads/AI/'.date('Ymd').'/'.$info->getFilename(),     //图片
                'nick_name'=>input('nickName'),
                );
            return json(['msg'=>'成功','code'=>'200','re_dum'=>$re_dum]);
             
        }
    }
    public function base64EncodeImage($image_path) {
     $base64_image = '';
     $image_info = getimagesize($image_path);
     $image_data = fread(fopen($image_path, 'r'), filesize($image_path));
     $base64_image = chunk_split(base64_encode($image_data));
     return $base64_image;
    }
    public function request_post($url = '', $param = '') {
        if (empty($url) || empty($param)) {
            return false;
        }
        $postUrl = $url;
        $curlPost = $param;
        $curl = curl_init();//初始化curl
        curl_setopt($curl, CURLOPT_URL,$postUrl);//抓取指定网页
        curl_setopt($curl, CURLOPT_HEADER, 0);//设置header
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);//要求结果为字符串且输出到屏幕上
        curl_setopt($curl, CURLOPT_POST, 1);//post提交方式
        curl_setopt($curl, CURLOPT_POSTFIELDS, $curlPost);
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
        $data = curl_exec($curl);//运行curl
        curl_close($curl);
        
        return $data;
    }
    public function getAI(){
            $resSetupAI=db('minwx_setup')->find();

            $img=ROOT_PATH.'/public/static/uploads/AI/yan.jpg';
            // $img=ROOT_PATH.'/public/static/uploads/AI/timg.jpg';
            $url = 'https://aip.baidubce.com/oauth/2.0/token';
            $post_data['grant_type'] = 'client_credentials';
            $post_data['client_id'] = $resSetupAI['client_id'];
            $post_data['client_secret'] = $resSetupAI['client_secret'];
            $o = "";
            foreach ( $post_data as $k => $v ) 
            {
                $o.= "$k=" . urlencode( $v ). "&" ;
            }
            $post_data = substr($o,0,-1);
            
            $res =$this->request_post($url, $post_data);
            $jsonarr = json_decode($res, true);
            $token=$jsonarr['access_token'];
            $token = $token;

            $url = 'https://aip.baidubce.com/rest/2.0/face/v3/detect?access_token=' . $token;
            $param = array(
              'image' => $this->base64EncodeImage($img),
              'image_type' => 'BASE64',
              'face_field' => 'age,beauty,expression,gender,emotion,quality'
              // 'face_field' => 'age,beauty,expression,face_shape,gender,glasses,landmark,landmark150,race,quality,eye_status,emotion,face_type'
             );
             $param = json_encode($param);
             $res =$this->request_post($url, $param);
             $result = json_decode($res, true);
             if($result['error_code'] != 0){
                 return json(['msg'=>'失败','code'=>'700','message'=>'上传的人脸不符合要求，请重新上传五官清晰的真实头像']);
                 die;
             }
             $quality = $result['result']['face_list'][0]['age'];  //年龄 
             // $beauty = $result['result']['face_list'][0]['beauty'];
             $beauty = round($result['result']['face_list'][0]['beauty']); //美丑打分，范围0-100，越大表示越美
             $expression = $result['result']['face_list'][0]['expression']['type'];   //表情none:不笑；smile:微笑；laugh:大笑
             $gender = $result['result']['face_list'][0]['gender']['type'];// 性别 male:男性 female:女性
             $emotion = $result['result']['face_list'][0]['emotion']['type'];  //情绪 angry:愤怒 disgust:厌恶 fear:恐惧 happy:高兴 sad:伤心 surprise:惊讶 neutral:无情绪
             $eye_status = $result['result']['face_list'][0]['quality'];
             // $eye_statusL = $result['result']['face_list'][0]['eye_status']['left_eye'];  //左眼状态 [0,1]取值，越接近0闭合的可能性越大
             // $eye_statusR = $result['result']['face_list'][0]['eye_status']['right_eye']; //右眼状态 [0,1]取值，越接近0闭合的可能性越大
             halt($result);
    }