Files
CompanyProject/金壶/ydyd_service/extend/BaiduOcr/AipFace.php
2024-09-27 01:32:49 +08:00

544 lines
24 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?php
/*
* Copyright (c) 2017 Baidu.com, Inc. All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* Http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
require_once 'lib/AipBase.php';
class AipFace extends AipBase {
/**
* 人脸检测 detect api url
* @var string
*/
private $detectUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/detect';
/**
* 人脸搜索 search api url
* @var string
*/
private $searchUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/search';
/**
* 人脸搜索 M:N 识别 multi_search api url
* @var string
*/
private $multiSearchUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/multi-search';
/**
* 人脸注册 user_add api url
* @var string
*/
private $userAddUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/user/add';
/**
* 人脸更新 user_update api url
* @var string
*/
private $userUpdateUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/user/update';
/**
* 人脸删除 face_delete api url
* @var string
*/
private $faceDeleteUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/face/delete';
/**
* 用户信息查询 user_get api url
* @var string
*/
private $userGetUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/user/get';
/**
* 获取用户人脸列表 face_getlist api url
* @var string
*/
private $faceGetlistUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/face/getlist';
/**
* 获取用户列表 group_getusers api url
* @var string
*/
private $groupGetusersUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/group/getusers';
/**
* 复制用户 user_copy api url
* @var string
*/
private $userCopyUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/user/copy';
/**
* 删除用户 user_delete api url
* @var string
*/
private $userDeleteUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/user/delete';
/**
* 创建用户组 group_add api url
* @var string
*/
private $groupAddUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/group/add';
/**
* 删除用户组 group_delete api url
* @var string
*/
private $groupDeleteUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/group/delete';
/**
* 组列表查询 group_getlist api url
* @var string
*/
private $groupGetlistUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceset/group/getlist';
/**
* 身份验证 person_verify api url
* @var string
*/
private $personVerifyUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/person/verify';
/**
* 语音校验码接口 video_sessioncode api url
* @var string
*/
private $videoSessioncodeUrl = 'https://aip.baidubce.com/rest/2.0/face/v1/faceliveness/sessioncode';
/**
* 人脸检测接口
*
* @param string $image - 图片信息(**总数据大小应小于10M**)图片上传方式根据image_type来判断
* @param string $imageType - 图片类型 **BASE64**:图片的base64值base64编码后的图片数据需urlencode编码后的图片大小不超过2M**URL**:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)**FACE_TOKEN**: 人脸图片的唯一标识调用人脸检测接口时会为每个人脸图片赋予一个唯一的FACE_TOKEN同一张图片多次检测得到的FACE_TOKEN是同一个
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* face_field 包括**age,beauty,expression,face_shape,gender,glasses,landmark,landmark72landmark150race,quality,eye_status,emotion,face_type信息** <br> 逗号分隔. 默认只返回face_token、人脸框、概率和旋转角度
* max_face_num 最多处理人脸的数目默认值为1仅检测图片中面积最大的那个人脸**最大值10**,检测图片中面积最大的几张人脸。
* face_type 人脸的类型 **LIVE**表示生活照:通常为手机、相机拍摄的人像图片、或从网络获取的人像图片等**IDCARD**表示身份证芯片照:二代身份证内置芯片中的人像照片 **WATERMARK**表示带水印证件照:一般为带水印的小图,如公安网小图 **CERT**表示证件照片:如拍摄的身份证、工卡、护照、学生证等证件图片 默认**LIVE**
* liveness_control 活体检测控制 **NONE**: 不进行控制 **LOW**:较低的活体要求(高通过率 低攻击拒绝率) **NORMAL**: 一般的活体要求(平衡的攻击拒绝率, 通过率) **HIGH**: 较高的活体要求(高攻击拒绝率 低通过率) **默认NONE**
* @return array
*/
public function detect($image, $imageType, $options=array()){
$data = array();
$data['image'] = $image;
$data['image_type'] = $imageType;
$data = array_merge($data, $options);
return $this->request($this->detectUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 人脸搜索接口
*
* @param string $image - 图片信息(**总数据大小应小于10M**)图片上传方式根据image_type来判断
* @param string $imageType - 图片类型 **BASE64**:图片的base64值base64编码后的图片数据需urlencode编码后的图片大小不超过2M**URL**:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)**FACE_TOKEN**: 人脸图片的唯一标识调用人脸检测接口时会为每个人脸图片赋予一个唯一的FACE_TOKEN同一张图片多次检测得到的FACE_TOKEN是同一个
* @param string $groupIdList - 从指定的group中进行查找 用逗号分隔,**上限20个**
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* max_face_num 最多处理人脸的数目<br>**默认值为1(仅检测图片中面积最大的那个人脸)** **最大值10**
* match_threshold 匹配阈值设置阈值后score低于此阈值的用户信息将不会返回 最大100 最小0 默认80 <br>**此阈值设置得越高,检索速度将会越快,推荐使用默认阈值`80`**
* quality_control 图片质量控制 **NONE**: 不进行控制 **LOW**:较低的质量要求 **NORMAL**: 一般的质量要求 **HIGH**: 较高的质量要求 **默认 NONE**
* liveness_control 活体检测控制 **NONE**: 不进行控制 **LOW**:较低的活体要求(高通过率 低攻击拒绝率) **NORMAL**: 一般的活体要求(平衡的攻击拒绝率, 通过率) **HIGH**: 较高的活体要求(高攻击拒绝率 低通过率) **默认NONE**
* user_id 当需要对特定用户进行比对时指定user_id进行比对。即人脸认证功能。
* max_user_num 查找后返回的用户数量。返回相似度最高的几个用户默认为1最多返回50个。
* @return array
*/
public function search($image, $imageType, $groupIdList, $options=array()){
$data = array();
$data['image'] = $image;
$data['image_type'] = $imageType;
$data['group_id_list'] = $groupIdList;
$data = array_merge($data, $options);
return $this->request($this->searchUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 人脸搜索 M:N 识别接口
*
* @param string $image - 图片信息(**总数据大小应小于10M**)图片上传方式根据image_type来判断
* @param string $imageType - 图片类型 **BASE64**:图片的base64值base64编码后的图片数据需urlencode编码后的图片大小不超过2M**URL**:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)**FACE_TOKEN**: 人脸图片的唯一标识调用人脸检测接口时会为每个人脸图片赋予一个唯一的FACE_TOKEN同一张图片多次检测得到的FACE_TOKEN是同一个
* @param string $groupIdList - 从指定的group中进行查找 用逗号分隔,**上限20个**
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* max_face_num 最多处理人脸的数目<br>**默认值为1(仅检测图片中面积最大的那个人脸)** **最大值10**
* match_threshold 匹配阈值设置阈值后score低于此阈值的用户信息将不会返回 最大100 最小0 默认80 <br>**此阈值设置得越高,检索速度将会越快,推荐使用默认阈值`80`**
* quality_control 图片质量控制 **NONE**: 不进行控制 **LOW**:较低的质量要求 **NORMAL**: 一般的质量要求 **HIGH**: 较高的质量要求 **默认 NONE**
* liveness_control 活体检测控制 **NONE**: 不进行控制 **LOW**:较低的活体要求(高通过率 低攻击拒绝率) **NORMAL**: 一般的活体要求(平衡的攻击拒绝率, 通过率) **HIGH**: 较高的活体要求(高攻击拒绝率 低通过率) **默认NONE**
* max_user_num 查找后返回的用户数量。返回相似度最高的几个用户默认为1最多返回50个。
* @return array
*/
public function multiSearch($image, $imageType, $groupIdList, $options=array()){
$data = array();
$data['image'] = $image;
$data['image_type'] = $imageType;
$data['group_id_list'] = $groupIdList;
$data = array_merge($data, $options);
return $this->request($this->multiSearchUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 人脸注册接口
*
* @param string $image - 图片信息(总数据大小应小于10M)图片上传方式根据image_type来判断。注组内每个uid下的人脸图片数目上限为20张
* @param string $imageType - 图片类型 **BASE64**:图片的base64值base64编码后的图片数据需urlencode编码后的图片大小不超过2M**URL**:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)**FACE_TOKEN**: 人脸图片的唯一标识调用人脸检测接口时会为每个人脸图片赋予一个唯一的FACE_TOKEN同一张图片多次检测得到的FACE_TOKEN是同一个
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* user_info 用户资料长度限制256B
* quality_control 图片质量控制 **NONE**: 不进行控制 **LOW**:较低的质量要求 **NORMAL**: 一般的质量要求 **HIGH**: 较高的质量要求 **默认 NONE**
* liveness_control 活体检测控制 **NONE**: 不进行控制 **LOW**:较低的活体要求(高通过率 低攻击拒绝率) **NORMAL**: 一般的活体要求(平衡的攻击拒绝率, 通过率) **HIGH**: 较高的活体要求(高攻击拒绝率 低通过率) **默认NONE**
* action_type 操作方式 APPEND: 当user_id在库中已经存在时对此user_id重复注册时新注册的图片默认会追加到该user_id下,REPLACE : 当对此user_id重复注册时,则会用新图替换库中该user_id下所有图片,默认使用APPEND
* @return array
*/
public function addUser($image, $imageType, $groupId, $userId, $options=array()){
$data = array();
$data['image'] = $image;
$data['image_type'] = $imageType;
$data['group_id'] = $groupId;
$data['user_id'] = $userId;
$data = array_merge($data, $options);
return $this->request($this->userAddUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 人脸更新接口
*
* @param string $image - 图片信息(**总数据大小应小于10M**)图片上传方式根据image_type来判断
* @param string $imageType - 图片类型 **BASE64**:图片的base64值base64编码后的图片数据需urlencode编码后的图片大小不超过2M**URL**:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)**FACE_TOKEN**: 人脸图片的唯一标识调用人脸检测接口时会为每个人脸图片赋予一个唯一的FACE_TOKEN同一张图片多次检测得到的FACE_TOKEN是同一个
* @param string $groupId - 更新指定groupid下uid对应的信息
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* user_info 用户资料长度限制256B
* quality_control 图片质量控制 **NONE**: 不进行控制 **LOW**:较低的质量要求 **NORMAL**: 一般的质量要求 **HIGH**: 较高的质量要求 **默认 NONE**
* liveness_control 活体检测控制 **NONE**: 不进行控制 **LOW**:较低的活体要求(高通过率 低攻击拒绝率) **NORMAL**: 一般的活体要求(平衡的攻击拒绝率, 通过率) **HIGH**: 较高的活体要求(高攻击拒绝率 低通过率) **默认NONE**
* action_type 操作方式 APPEND: 当user_id在库中已经存在时对此user_id重复注册时新注册的图片默认会追加到该user_id下,REPLACE : 当对此user_id重复注册时,则会用新图替换库中该user_id下所有图片,默认使用APPEND
* @return array
*/
public function updateUser($image, $imageType, $groupId, $userId, $options=array()){
$data = array();
$data['image'] = $image;
$data['image_type'] = $imageType;
$data['group_id'] = $groupId;
$data['user_id'] = $userId;
$data = array_merge($data, $options);
return $this->request($this->userUpdateUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 人脸删除接口
*
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param string $faceToken - 需要删除的人脸图片token由数字、字母、下划线组成长度限制64B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* @return array
*/
public function faceDelete($userId, $groupId, $faceToken, $options=array()){
$data = array();
$data['user_id'] = $userId;
$data['group_id'] = $groupId;
$data['face_token'] = $faceToken;
$data = array_merge($data, $options);
return $this->request($this->faceDeleteUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 用户信息查询接口
*
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* @return array
*/
public function getUser($userId, $groupId, $options=array()){
$data = array();
$data['user_id'] = $userId;
$data['group_id'] = $groupId;
$data = array_merge($data, $options);
return $this->request($this->userGetUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 获取用户人脸列表接口
*
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* @return array
*/
public function faceGetlist($userId, $groupId, $options=array()){
$data = array();
$data['user_id'] = $userId;
$data['group_id'] = $groupId;
$data = array_merge($data, $options);
return $this->request($this->faceGetlistUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 获取用户列表接口
*
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* start 默认值0起始序号
* length 返回数量默认值100最大值1000
* @return array
*/
public function getGroupUsers($groupId, $options=array()){
$data = array();
$data['group_id'] = $groupId;
$data = array_merge($data, $options);
return $this->request($this->groupGetusersUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 复制用户接口
*
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* src_group_id 从指定组里复制信息
* dst_group_id 需要添加用户的组id
* @return array
*/
public function userCopy($userId, $options=array()){
$data = array();
$data['user_id'] = $userId;
$data = array_merge($data, $options);
return $this->request($this->userCopyUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 删除用户接口
*
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param string $userId - 用户id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* @return array
*/
public function deleteUser($groupId, $userId, $options=array()){
$data = array();
$data['group_id'] = $groupId;
$data['user_id'] = $userId;
$data = array_merge($data, $options);
return $this->request($this->userDeleteUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 创建用户组接口
*
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* @return array
*/
public function groupAdd($groupId, $options=array()){
$data = array();
$data['group_id'] = $groupId;
$data = array_merge($data, $options);
return $this->request($this->groupAddUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 删除用户组接口
*
* @param string $groupId - 用户组id由数字、字母、下划线组成长度限制128B
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* @return array
*/
public function groupDelete($groupId, $options=array()){
$data = array();
$data['group_id'] = $groupId;
$data = array_merge($data, $options);
return $this->request($this->groupDeleteUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 组列表查询接口
*
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* start 默认值0起始序号
* length 返回数量默认值100最大值1000
* @return array
*/
public function getGroupList($options=array()){
$data = array();
$data = array_merge($data, $options);
return $this->request($this->groupGetlistUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 身份验证接口
*
* @param string $image - 图片信息(**总数据大小应小于10M**)图片上传方式根据image_type来判断
* @param string $imageType - 图片类型 **BASE64**:图片的base64值base64编码后的图片数据需urlencode编码后的图片大小不超过2M**URL**:图片的 URL地址( 可能由于网络等原因导致下载图片时间过长)**FACE_TOKEN**: 人脸图片的唯一标识调用人脸检测接口时会为每个人脸图片赋予一个唯一的FACE_TOKEN同一张图片多次检测得到的FACE_TOKEN是同一个
* @param string $idCardNumber - 身份证号(真实身份证号号码)
* @param string $name - utf8姓名真实姓名和身份证号匹配
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* quality_control 图片质量控制 **NONE**: 不进行控制 **LOW**:较低的质量要求 **NORMAL**: 一般的质量要求 **HIGH**: 较高的质量要求 **默认 NONE**
* liveness_control 活体检测控制 **NONE**: 不进行控制 **LOW**:较低的活体要求(高通过率 低攻击拒绝率) **NORMAL**: 一般的活体要求(平衡的攻击拒绝率, 通过率) **HIGH**: 较高的活体要求(高攻击拒绝率 低通过率) **默认NONE**
* @return array
*/
public function personVerify($image, $imageType, $idCardNumber, $name, $options=array()){
$data = array();
$data['image'] = $image;
$data['image_type'] = $imageType;
$data['id_card_number'] = $idCardNumber;
$data['name'] = $name;
$data = array_merge($data, $options);
return $this->request($this->personVerifyUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 语音校验码接口接口
*
* @param array $options - 可选参数对象key: value都为string类型
* @description options列表:
* appid 百度云创建应用时的唯一标识ID
* @return array
*/
public function videoSessioncode($options=array()){
$data = array();
$data = array_merge($data, $options);
return $this->request($this->videoSessioncodeUrl, json_encode($data), array(
'Content-Type' => 'application/json',
));
}
/**
* 在线活体检测 faceverify api url
* @var string
*/
private $faceverifyUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/faceverify';
/**
* 在线活体检测接口
*
* @param array $images
* @return array
*/
public function faceverify($images){
return $this->request($this->faceverifyUrl, json_encode($images), array(
'Content-Type' => 'application/json',
));
}
/**
* 人脸比对 match api url
* @var string
*/
private $matchUrl = 'https://aip.baidubce.com/rest/2.0/face/v3/match';
/**
* 人脸比对接口
*
* @param array $images
* @return array
*/
public function match($images){
return $this->request($this->matchUrl, json_encode($images), array(
'Content-Type' => 'application/json',
));
}
}