【PHP】接入百度AI开放平台人脸识别API,实现人脸对比

目录

一、需求

二、准备工作

1、申请服务

2、创建应用,获取开发密钥

3、官方开发文档

4、测试人像图片

三、PHP接入

1、鉴权,获取access_token

2、人脸对比

四、完整代码


一、需求

现在人脸识别、人脸对比技术越来越成熟,使用越来越广泛,比较好的是百度AI开放平台提供的人脸对比接口,对接简单,那么怎样通过PHP来接入人脸识别的接口,以实现人脸识别呢?本篇文章详细介绍PHP接入百度AI人脸识别PAI的全步骤。

二、准备工作

因为使用的是百度AI开放平台的人脸识别接口,就需要进入到百度开放平台注册/登录平台,创建人脸对比应用,获取AIP Key和Secret Key。

1、申请服务

进入百度开放平台,找到"开放能力->人脸与人体->人脸对比"服务,立即申请使用。

地址:人脸对比_人脸对比识别_人脸对比相似度-百度AI开放平台

2、创建应用,获取开发密钥

登录平台后进入控制台,点击左上角菜单,搜索并选择"人脸识别",点击右侧菜单应用列表,创建应用,勾选"人脸对比V3",立即创建,创建成功后会有PAI key和Secret Key。

详细接入说明:https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjgn3

3、官方开发文档

每个用户都有一定的免费测试额度,个人认证的账号与企业认证的账号免费额度也不同。人脸识别接口有V2、V3、V4三个版本,由于我是个人认证的账号,所以使用的是V3版本。

V3版本开发文档:https://ai.baidu.com/ai-doc/FACE/Lk37c1tpf

V4版本开发文档:https://ai.baidu.com/ai-doc/FACE/Oktmssfse

4、测试人像图片

准备几张用于测试的人像图片

三、PHP接入

1、鉴权,获取access_token

**接口描述:**获取access_token

名称 说明
接口名称 鉴权,获取access_token
接口地址 https://aip.baidubce.com/oauth/2.0/token
请求方式 GET/POST(推荐)
官方文档 https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjhhu

请求参数说明

参数 类型 必填 含义 说明
grant_type string 固定为client_credentials client_credentials
client_id string 应用的API Key,获取方式:https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjgn3 Va5yQRHlA4Fq5eR3LT0vuXV4
client_secret string 应用的Secret Key,获取方式:https://ai.baidu.com/ai-doc/REFERENCE/Ck3dwjgn3 0rDSjzQ20XUj5itV6WRtznPQSzr5pVw2

返回参数说明

名称 类型 含义
access_token string 要获取的Access Token
refresh_token string 该参数忽略
expires_in string Access Token的有效期(秒为单位,有效期30天)
scope string 该参数忽略
session_key string 该参数忽略
session_secret string 该参数忽略

代码示例

php 复制代码
// 鉴权,获取token
public function getToken()
{
	    $apiUrl = 'https://aip.baidubce.com/oauth/2.0/token';
        $params = [
                "grant_type" => 'client_credentials',
                'client_id' => $this->api_key,
                "client_secret" => $this->secret_key,
        ];
        $params = http_build_query($params);

        $result = $this->returnArray($this->freeApiCurl($apiUrl,$params));

        $access_token = $result['access_token'];
        return $access_token;
}

2、人脸对比

**接口描述:**人脸对比V3,对比两张图片中的人脸的相似度,并返回相似度分值。

名称 说明
接口名称 人脸对比
接口地址 https://aip.baidubce.com/rest/2.0/face/v3/match
请求方式 POST
官方文档 https://ai.baidu.com/ai-doc/FACE/Lk37c1tpf

请求参数说明

参数 类型 必填 含义
image string 图片信息(总数据大小应小于10M,图片尺寸在1920x1080以下 ),图片上传方式根据image_type来判断。 两张图片通过json格式上传,格式参考本表格下方的示例
image_type string 图片类型 BASE64 :(推荐 )图片的base64值,base64编码后的图片数据,编码后的图片大小不超过2M; FACE_TOKEN: 人脸图片的唯一标识,调用人脸检测接口时,会为每个人脸图片赋予一个唯一的FACE_TOKEN,同一张图片多次检测得到的FACE_TOKEN是同一个。
face_type string 人脸的类型 LIVE :表示生活照:通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等, IDCARD :表示身份证芯片照:二代身份证内置芯片中的人像照片, WATERMARK :表示带水印证件照:一般为带水印的小图,如公安网小图 CERT :表示证件照片:如拍摄的身份证、工卡、护照、学生证等证件图片 INFRARED 表示红外照片:使用红外相机拍摄的照片 HYBRID :表示混合类型,如果传递此值时会先对图片进行检测判断所属类型(生活照 or 证件照)(仅针对请求参数 image_type 为 BASE64 或 URL 时有效) 默认LIVE
quality_control string 图片质量控制 NONE : 不进行控制 LOW :较低的质量要求 NORMAL : 一般的质量要求 HIGH : 较高的质量要求 默认 NONE 若图片质量不满足要求,则返回结果中会提示质量检测失败
liveness_control string 活体检测控制 NONE : 不进行控制 LOW :较低的活体要求(高通过率 低攻击拒绝率) NORMAL : 一般的活体要求(平衡的攻击拒绝率, 通过率) HIGH : 较高的活体要求(高攻击拒绝率 低通过率) 默认 NONE 若活体检测结果不满足要求,则返回结果中会提示活体检测失败
face_sort_type string 人脸检测排序类型 0 :代表检测出的人脸按照人脸面积从大到小排列 1 :代表检测出的人脸按照距离图片中心从近到远排列 默认为0
spoofing_control string 合成图控制参数 NONE : 不进行控制 LOW :较低的合成图阈值数值,由于合成图判定逻辑为大于阈值视为合成图攻击,该项代表低通过率、高攻击拒绝率 NORMAL : 一般的合成图阈值数值,由于合成图判定逻辑为大于阈值视为合成图攻击,该项代表平衡的攻击拒绝率, 通过率 HIGH : 较高的合成图阈值数值,由于合成图判定逻辑为大于阈值视为合成图攻击,该项代表高通过率、低攻击拒绝率 默认为NONE

返回参数说明

名称 类型 含义
score float 要获取的Access Token
face_list array 人脸信息列表,列表里的face_token顺序与传入的图片顺序保存一致
face_token string 人脸的唯一标志

**质量控制参数说明:**不同的控制度下所对应的质量控制阈值,如果检测出来的质量信息某一项不符合控制阈值的要求,则会返回错误信息。

控制参数说明文档: https://ai.baidu.com/ai-doc/FACE/Lk37c1tpf

代码示例

php 复制代码
public function run()
{
        $img1 = 'static/index/images/11.png';
        $img2 = 'static/index/images/22.png';

        // 读取图片文件内容
        $imageContent1 = file_get_contents($img1);
        $imageContent2 = file_get_contents($img2);
        // 将图片内容转换为Base64编码
        $base64Image1 = base64_encode($imageContent1);
        $base64Image2 = base64_encode($imageContent2);

        $apiUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/match?access_token='.$this->getToken();
        $params = [
                [
                        'image' => $base64Image1,
                        'image_type' => 'BASE64',
                        'face_type' => 'LIVE',          // 人脸的类型
                        'quality_control' => 'HIGH',    // 图片质量控制
                        'liveness_control' => 'NONE'    // 活体检测控制
                ],
                [
                        'image' => $base64Image2,
                        'image_type' => 'BASE64',
                        'face_type' => 'LIVE',          // 人脸的类型
                        'quality_control' => 'HIGH',    // 图片质量控制
                        'liveness_control' => 'NONE'    // 活体检测控制
                ]
        ];

        // 参数 数组格式转json格式
        $params = json_encode($params);
        $result = $this->returnArray($this->freeApiCurl($apiUrl,$params,1));

}

需要注意的几点

1、access_token的有效期为30天,切记需要每30天进行定期更换,或者每次请求都拉取新token;

2、请求参数是json,不是数组,在传入之前先转成json格式;

3、传入的图片(image字段)大小不超过10M,尺寸在1920*1080以下,必须是base64编码,且不包含图片头,如data:image/jpg;base64,使用前请检查一边;

4、图片格式先仅支持png、jpg、jpeg、bmp格式;

5、人脸类型、图片质量控制、活体检测控制设置不同的阈值也会返回不同的结果或错误,错误可参看错误码,所以需要根据实际需求设置阈值。

四、完整代码

使用ThinkPHP5框架,替换自己的api_key和secret_key即可。

php 复制代码
<?php
namespace app\index\controller;
use think\Controller;

class Face extends Controller
{
	private $api_key = 'xxxxxx';
	private $secret_key = 'xxxxxxx';

	// 鉴权,获取token
	public function getToken()
	{
		$apiUrl = 'https://aip.baidubce.com/oauth/2.0/token';
        $params = [
                "grant_type" => 'client_credentials',
                'client_id' => $this->api_key,
                "client_secret" => $this->secret_key,
            ];
        $params = http_build_query($params);

        $result = $this->returnArray($this->freeApiCurl($apiUrl,$params));

        $access_token = $result['access_token'];
        return $access_token;
	}

	public function run()
	{
		$img1 = 'static/index/images/11.png';
		$img2 = 'static/index/images/22.png';

		// 读取图片文件内容
		$imageContent1 = file_get_contents($img1);
		$imageContent2 = file_get_contents($img2);
		// 将图片内容转换为Base64编码
		$base64Image1 = base64_encode($imageContent1);
		$base64Image2 = base64_encode($imageContent2);

		$apiUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/match?access_token='.$this->getToken();
		$params = [
			[
				'image' => $base64Image1,
				'image_type' => 'BASE64',
				'face_type' => 'LIVE',		// 人脸的类型
				'quality_control' => 'HIGH',	// 	图片质量控制
				'liveness_control' => 'NONE'	// 活体检测控制
			],
			[
				'image' => $base64Image2,
				'image_type' => 'BASE64',
				'face_type' => 'LIVE',		// 人脸的类型
				'quality_control' => 'HIGH',	// 	图片质量控制
				'liveness_control' => 'NONE'	// 活体检测控制
			]
		];

		// 参数 数组格式转json格式
		$params = json_encode($params);
        $result = $this->returnArray($this->freeApiCurl($apiUrl,$params,1));
	}


	/**
     * 将JSON内容转为数组,并返回
     */
    public function returnArray($content){
        return json_decode($content,true);
    }
    
    /**
     * @describe CURL操作,支持POST和GET两种请求方式
     * @param $url:API接口请求地址,$param:请求参数,$ispost:请求方式 post=1/get=2
     * @return array  接口返回结果集
     */
    public function freeApiCurl($url,$params=false,$ispost=0){
        $ch = curl_init();
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_HTTP_VERSION , CURL_HTTP_VERSION_1_1 );
        curl_setopt( $ch, CURLOPT_CONNECTTIMEOUT , 60 );
        curl_setopt( $ch, CURLOPT_TIMEOUT , 60);
        curl_setopt( $ch, CURLOPT_RETURNTRANSFER , true );
        if( $ispost )
        {
            curl_setopt( $ch , CURLOPT_POST , true );
            curl_setopt( $ch , CURLOPT_POSTFIELDS , $params );
            curl_setopt( $ch , CURLOPT_URL , $url );
        }
        else
        {
            if($params){
                curl_setopt( $ch , CURLOPT_URL , $url.'?'.$params );
            }else{
                curl_setopt( $ch , CURLOPT_URL , $url);
            }
        }
        $response = curl_exec( $ch );
        if ($response === FALSE) {
            return false;
        }
        curl_close( $ch );
        return $response;
    }


}

返回结果

相关推荐
时序之心6 分钟前
ICML 2025 | 深度剖析时序 Transformer:为何有效,瓶颈何在?
人工智能·深度学习·transformer
conkl11 分钟前
嵌入式 Linux 深度解析:架构、原理与工程实践(增强版)
linux·运维·服务器·架构·php·底层·堆栈
希艾席帝恩21 分钟前
拥抱智慧物流时代:数字孪生技术的应用与前景
大数据·人工智能·低代码·数字化转型·业务系统
Bar_artist24 分钟前
离线智能破局,架构创新突围:RockAI与中国AI的“另一条车道”
大数据·人工智能
双向3330 分钟前
高性能MCP服务器架构设计:并发、缓存与监控
人工智能
weixin_4640780737 分钟前
机器学习sklearn:处理缺失值
人工智能·机器学习·sklearn
2202_7567496940 分钟前
04 基于sklearn的机械学习-梯度下降(上)
人工智能·算法·机器学习
网安Ruler1 小时前
Web开发-PHP应用&TP框架&MVC模型&路由访问&模版渲染&安全写法&版本漏洞
前端·php·mvc
图灵学术计算机论文辅导1 小时前
提示+掩膜+注意力=Mamba三连击,跨模态任务全面超越
论文阅读·人工智能·经验分享·科技·深度学习·考研·计算机视觉
Albert_Lsk2 小时前
【2025/08/01】GitHub 今日热门项目
人工智能·开源·github·开源协议