腾讯云人脸检索引入教程

2019-12-11 18:11:46 浏览数 (1)

人脸检索

先说下什么是人脸检索：

本接口用于对一张待识别的人脸图片，在一个 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 环境下执行：

代码语言：javascript复制
<?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.myzijiebao.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！

提供下检索用的两张图片：

声明：图片均来自互联网，不确认版权，若侵权请通知删除！

参考：

  • 鉴权签名官方文档
  • 人脸检索官方文档地址
  • 个体信息管理方文档地址 ​
人脸识别

0 人点赞