腾讯云人脸检索引入教程
人脸检索
先说下什么是人脸检索：
本接口用于对一张待识别的人脸图片，在一个 group 中识别出最相似的 Top5 person 作为其身份返回，返回的 Top5 中按照相似度从大到小排列。
Qcloud 官方文档中是这样定义人脸检索的 API 的概述的。
用大白话来说，就是从一张合影中，匹配出与默认添加个体最相似的一个个体（API会给出最高的五个，从匹配度由高到低排列）。
那么接下来看看如何操作：
创建鉴权签名
Qcloud 的付费接口，在调用的时候大多都需要进行鉴权签名的认证，而鉴权签名这需要使用用的 APPID 、Bucket、Secret ID 和 Secret Key。
另外： （1）如果您使用的是 125 开头的 APPID，请使用 API 密钥 ； （2）如果您使用的是 100、101 等开头的 项目 ID，请使用 项目密钥。
点击上述链接，进入新建或查看秘钥：
保存如图所示的三个值，而 Bucket 存储桶，则可以前往COS云对象存储 创建并获取其 Bucket 的名称：
现在，我们拥有了创建鉴权签名所需的四个参数，选择合适的环境创建即可：
鉴权签名的官方示例提供了两种方法来完成鉴权签名的生成，分别依托 PHP 和 JAVA 环境，
这里我们使用已有的 PHP 环境来执行，将官方提供的鉴权签名生成代码添加到一个 PHP 页面中，并上传到 PHP 环境下执行：
<?php
$appid = "1252821871";
$bucket = "tencentyun";
$secret_id = "AKIDgaoOYh2kOmJfWVdH4lpfxScG2zPLPGoK";
$secret_key = "nwOKDouy5JctNOlnere4gkVoOUz5EYAb";
$expired = time() + 2592000;
$onceExpired = 0;
$current = time();
$rdm = rand();
$userid = "0";
$fileid = "tencentyunSignTest";
$srcStr = 'a='.$appid.'&b='.$bucket.'&k='.$secret_id.'&e='.$expired.'&t='.$current.'&r='.$rdm.'&u='
.$userid.'&f=';
$srcWithFile = 'a='.$appid.'&b='.$bucket.'&k='.$secret_id.'&e='.$expired.'&t='.$current.'&r='.$rdm.'&u='
.$userid.'&f='.$fileid;
$srcStrOnce= 'a='.$appid.'&b='.$bucket.'&k='.$secret_id.'&e='.$onceExpired .'&t='.$current.'&r='.$rdm
.'&u='.$userid.'&f='.$fileid;
$signStr = base64_encode(hash_hmac('SHA1', $srcStr, $secret_key, true).$srcStr);
$srcWithFile = base64_encode(hash_hmac('SHA1', $srcWithFile , $secret_key, true).$srcWithFile );
$signStrOnce = base64_encode(hash_hmac('SHA1',$srcStrOnce,$secret_key, true).$srcStrOnce);
echo "多次有效签名(不绑定资源) " + $signStr."\n";
echo "多次有效签名(绑定资源) " + $srcWithFile ."\n";
echo "单次有效签名 " + $signStrOnce."\n";
?>注意:将上述php 页面代码的前四项修改为刚才获取到的对应内容！
然后访问当前 php 页面，即可获得鉴权签名的内容！
注意: 鉴权签名是执行请求并计费的秘钥，在使用过程中注意保密，若泄露易导致他人盗用，产生不必要的额外开支。
完成鉴权签名后，就可以开始使用人脸检索的 API 了。
创建个体
在让人脸检索服务能为我们检索到信息之前，我们先需要上传个体。
这里使用 Postman 作为请求处理工具，选择一个我比较喜欢的演员高司令(Ryan Gosling作为个体，然后在使用人脸检索服务，在合影中找出他。
请求头：
参数名 | 值 | 描述 |
|---|---|---|
host | recognition.image.myqcloud.com | 腾讯云人脸识别服务器域名 |
content-length | 包体总长度 | 整个请求包体内容的总长度，单位：字节（Byte） |
content-type | application/json 或 multipart/form-data | 据不同接口选择：1. 使用 application/json 格式，参数为 url，其值为图片的 url ；2. 使用 multipart/form-data 格式，参数为 image，其值为图片的 base64 。 |
authorization | 鉴权签名 | 多次有效签名，用于鉴权，生成方式见 鉴权签名方法 |
请求参数
使用 application/json 格式，参数选择 url ；使用 multipart/form-data 格式，参数选择 image。
参数名 | 必选 | 类型 | 参数说明 |
|---|---|---|---|
appid | 是 | string | 接入项目的唯一标识，可在 账号信息 或 云 API 密钥 中查看。 |
group_ids | 是 | array(string) | 加入到组的列表 |
person_id | 是 | string | 指定的个体 id |
image | 否 | binary | 图片内容 |
url | 否 | string | 图片的 url、image提供一个即可；如果都提供，只使用url |
person_name | 否 | string | 名字 |
tag | 否 | string | 备注信息 |
按照上表，填写请求：
头部信息如下：
参数部分如下：
这里选择如图的所示的 raw 然后使用 json 模式编写，更加直观方便！
注意:图中所有参数请按自己需要请求的内容替换，如 appid 替换为自己的 appid，group 和 person 的 id 都由用户自行划分定义，person_name 为选填参数。
按要求填写完毕后，点击 sent，查看返回值：
返回值如上所示，则表示个体创建成功！
人脸校验
先看下参数：
请求参数
使用 application/json 格式，参数选择 url ；使用 multipart/form-data 格式，参数选择 image。
参数名 | 必选 | 类型 | 参数说明 |
|---|---|---|---|
appid | 是 | string | 接入项目的唯一标识，可在 账号信息 或 云 API 密钥 中查看。 |
group_id | 否 | string | 候选人组 id，与group_ids二选一即可 |
group_ids | 否 | array(string) | 候选人组 id列表，与group_id二选一即可 |
image | 否 | binary | 图片内容 |
url | 否 | string | image 和 url 只需提供一个；如果都提供，只使用 url |
返回内容
字段 | 类型 | 说明 |
|---|---|---|
data.session_id | string | 相应请求的 session 标识符，可用于结果查询 |
data.candidates | array(IdentifyItem) | 识别出的 top5 候选人 |
code | int | 返回状态码 |
message | string | 返回错误消息 |
人脸校验请求的请求头和创建个体的一样，直接按照上文添加，请求参数如下图所示：
点击 sent
从返回值中可以看出，人脸检索已经成功从合影中检索出了高司令！确认度64！
提供下检索用的两张图片：
声明：图片均来自互联网，不确认版权，若侵权请通知删除！