TencentYoutuyun-person-face-service php sdk for 腾讯云智能优图服务 & 腾讯优图开放平台 安装 ( 直接下载源码集成 ) 从 github 下载源码装入到您的程序中, 并加载 include.php 名词 AppId 平台添加应用后分配的 AppId SecretId 平台添加应用后分配的 SecretId SecretKey 平台添加应用后分配的 SecretKey 签名接口鉴权凭证, 由 AppId SecretId SecretKey 等生成, 详 见 http://open.youtu.qq.com/welcome/authentication 使用示例 // 引入 SDK require('./include.php'); use TencentYoutuyun\Youtu; use TencentYoutuyun\Conf; use TencentYoutuyun\Auth; // 设置 APP 鉴权信息 $appid='your appid'; $secretid='your secretid '; $secretkey='your secretkey'; $userid='your qq'; // 根据你使用的平台选择一种初始化方式 // 优图开放平台初始化 Conf::setAppInfo($appid, $secretid, $secretkey, $userid,conf::api_youtu_end_point); // 腾讯云初始化 Conf::setAppInfo($appid, $secretid, $secretkey, $userid,conf::api_tencentyun_end_point); // 人脸检测接口调用 $uploadret = YouTu::detectface('test.jpg', 1); var_dump($uploadret); 鉴权 接口调用时计算签名鉴权相关逻辑 Auth::appSign($expired, $userid) 获取签名, 依赖 conf 中的配置项
: 签名 expired 过期时间,UNIX 时间戳, 计算的签名在过期时间之前有效. userid 业务中的用户标识, 填写用户 QQ 号即可 其它 SDK API 介绍 auth.auth_params_error 错误常量 (-1) auth.auth_secret_id_key_error 密钥 ID 或者密钥 KEY 错误常量 (-2) 优图相关 API 封装, 均为同步函数 YouTu::detectface($image_path, $isbigface) YouTu::detectfaceurl($url, $isbigface) 人脸检测, 检测给定图片 (Image) 中的所有人脸 (Face) 的位置和相应的面部属性 位置包括 (x, y, w, h), 面 部属性包括性别 (gender) 年龄 (age) 表情 (expression) 眼镜 (glass) 和姿态 (pitch,roll,yaw) $isbigface 是否大脸模式 0 表示检测所有人脸, 1 表示只检测照片最大人脸 适合单人照模式 YouTu::faceshape($image_path, $isbigface) YouTu::faceshapeurl($url, $isbigface) 人脸定位, 检测给定图片中人脸的五官 对请求图片进行人脸配准, 计算构成人脸轮廓的 88 个点, 包括眉毛 ( 左右各 8 点 ) 眼睛 ( 左右各 8 点 ) 鼻子 (13 点 ) 嘴巴 (22 点 ) 脸型轮廓 (21 点 ) $isbigface 是否大脸模式 0 表示检测所有人脸, 1 表示只检测照片最大人脸 适合单人照模式 YouTu::facecompare($image_path_a, $image_path_b) YouTu::facecompareurl($urlA, $urlb) 人脸对比, 计算两个 Face 的相似性以及五官相似度 $image_path_a 第一张待检测图片路径 $image_path_b 第二张待检测图片路径 $urla 第一张图片 url $urlb 第二张图片 url
YouTu::faceverify($image_path, $person_id) YouTu::faceverifyurl($url,$person_id) 人脸验证, 给定一个 Face 和一个 Person, 返回是否是同一个人的判断以及置信度 $person_id 待验证的 Person YouTu::faceidentify($image_path, $group_id) YouTu::faceidentifyurl($url,$group_id) 人脸识别, 对于一个待识别的人脸图片, 在一个 Group 中识别出最相似的 Top5 Person 作为其身份返回, 返回 的 Top5 中按照相似度从大到小排列 $group_id 需要识别的人所在的组 YouTu::newperson($image_path, $person_id, array $group_ids, $person_name="", $perso n_tag="") YouTu::newpersonurl($url, $person_id, array $group_ids, $person_name="", $person_ta g="") 个体创建, 创建一个 Person, 并将 Person 放置到 $group_ids 指定的组当中 $person_id 个体 id $person_name 个体的名字 $group_ids 要加入的组的列表 ( 数组 ) $person_name 个体名称 $person_tag 备注信息, 用户自解释字段 YouTu::delperson($person_id) 删除一个 Person
YouTu::addface($person_id, $images, $facetag) YouTu::addfaceurl($person_id, $url_arr, $facetag="") 添加人脸, 在创建一个 Person 后, 增加 person 下面的人脸, 可以用于后面的比对 $images 待检测图片路径 ( 数组 ) $url_arr 图片 url( 数组 ) $facetag 人脸自定义标签 YouTu::delface($person_id, $face_ids) 删除人脸, 删除一个 person 下的 face, 包括特征, 属性和 face_id $face_ids 要删除的 faceid 列表 ( 数组 ) YouTu::setinfo($person_name, $person_id, $tag) 设置 Person 的信息 $person_name 个体 Person 的 name $tag 个体 Person 的 tag, 用户自解释字段 YouTu::getinfo($person_id) 获取一个 Person 的信息, 包括 name id $tag 相关的 face 以及 groups 等信息 YouTu::getgroupids() 获取一个 AppId 下所有 group 列表 YouTu::getpersonIds($group_id) 获取一个组 Group 中所有 person 列表 组
$group_id 组 YouTu::getfaceIds($person_id) 获取一个组 person 中所有 face 列表 YouTu::getfaceinfo($face_id) 获取一个 face 的相关特征信息 $face_id 需要获取的 faceid YouTu::fuzzydetect($image_path) YouTu::fuzzydetecturl($url) 判断一个图像的模糊程度 YouTu::fooddetect($image_path) YouTu::fooddetecturl($url) 识别一个图像是否为美食图像 YouTu::imagetag($image_path) YouTu::imagetagurl($url) 识别一个图像的标签信息, 对图像分类