阅读"Face++ 人脸识别文档"

人脸

人脸（Face）在人脸识别技术中特指图像中发现的人脸，当对一张图片进行人脸检测时，会将检测到的人脸记录下来，包括人脸在图片中的位置，用一个系统标识face_token来表示。注意：对同一张图片进行多次人脸检测，对同一个人脸会得到不同的face_token。

人脸集合

人脸集合（FaceSet）是用来存储检测到人脸的存储对象。一个FaceSet内face_token是不重复的。

人脸比对/人脸搜索

计算机检测到图片中一个人脸之后，通过人脸判断人身份的过程被称为人脸比对/人脸搜索。

人脸比对指采集新的人脸，与一个已知身份用户的人脸进行比对，判断新的人脸是否属于该已知身份用户。人脸比对需要调用Compare API。

人脸搜索是指采集用户新的人脸，在多个已知身份用户的人脸集合中进行搜索，找出新的人脸属于哪一个已知身份用户。人脸搜索需要调用Search API。

API调用——原理

Face++ 人工智能开放平台 API是HTTP API。常用的编程语言都能发起HTTP请求（通过第三方库或自带API），使用者向我们的服务器发起HTTP请求，并加上合适的参数，服务器将会对请求进行处理，得到结果将会返回给使用者。

API调用——鉴权
帐号下每创建一个应用就会生成一组对应的 api_key 和 api_secret，用以识别用户是否有权限调用 API，所有的API调用必须提供对应的一组 api_key 和 api_secret 参数。

API调用——参数
调用每个API需要根据需求传不同的参数，每个API参数的详细定义请查看 人脸识别 。所有 API 的调用都要使用 POST 请求，用户可以以 Query String 的形式将参数写进请求体中，传图片文件参数时则需要在请求体中使用 multipart/form-data 格式来编码。

API调用——提示
为了避免因网络问题而靠成的阻塞，建议将 API 调用放进异步线程里执行。

人脸检测

描述

调用者提供图片文件或者图片URL，进行人脸检测和人脸分析。识别出的人脸会给出face_token，用于后续的人脸比对等操作。请注意，只对人脸包围盒面积最大的5个人脸进行分析，其他人脸可以使用Face Analyze API进行分析。如果您需要使用检测出的人脸于后续操作，建议将对应face_token添加到FaceSet中。如果一个face_token连续72小时没有存放在任意FaceSet中，则该face_token将会失效。如果对同一张图片进行多次人脸检测，同一个人脸得到的face_token是不同的。

图片要求

图片格式：JPG(JPEG)，PNG图片像素尺寸：最小4848像素，最大40964096像素图片文件大小：2MB最小人脸像素尺寸： 系统能够检测到的人脸框为一个正方形，正方形边长的最小值为图像短边长度的48分之一，最小值不低于48像素。 例如图片为 40963200 像素，则最小人脸像素尺寸为 6666 像素。

更新日志

2017年6月7日：算法重大升级；提供表情识别 emotion。
2017年3月28日：支持base64编码的图片。
2017年3月9日：人脸检测算法升级；提供了眼睛状态检测eyestatus，替换是否戴眼镜 glass 的检测；人脸模糊检测升级；提供了人种检测。

调用URL
https://api-cn.faceplusplus.com/facepp/v3/detect

调用方法: POST

人脸对比

描述

将两个人脸进行比对，来判断是否为同一个人。支持传两张图片进行比对，或者一张图片与一个已知的face_token比对，也支持两个face_token进行比对。使用图片进行比对时会选取图片中检测到人脸尺寸最大的一个人脸。

图片要求

图片格式：JPG(JPEG)，PNG图片像素尺寸：最小4848像素，最大40964096像素图片文件大小：2MB最小人脸像素尺寸： 系统能够检测到的人脸框为一个正方形，正方形边长的最小值为150像素。

更新日志

2017年3月28日：支持base64编码的图片。

调用URL
https://api-cn.faceplusplus.com/facepp/v3/compare

调用方法: POST

人脸检索

描述

在Faceset中找出与目标人脸最相似的一张或多张人脸。支持传入face_token或者直接传入图片进行人脸搜索。使用图片进行比对时会选取图片中检测到人脸尺寸最大的一个人脸。

图片要求

图片格式：JPG(JPEG)，PNG图片像素尺寸：最小4848像素，最大40964096像素图片文件大小：2MB最小人脸像素尺寸： 系统能够检测到的人脸框为一个正方形，正方形边长的最小值为150像素。

更新日志

2017年3月28日：支持base64编码的图片。

调用URL
https://api-cn.faceplusplus.com/facepp/v3/search

调用方法: POST

脸关键点Landmark说明

Landmark对象结构
分别包括脸部，眼睛，眉毛，嘴唇，鼻子轮廓。下图为示例，绿点为Landmark关键点。

Landmark字段说明：

•   下文提及的坐标单位均为像素。
•   下文提及的“左”或“右”，均指图像中的左右，对于人脸照来说，是反向的。比如：下文提到的“左眼”实际为他的右眼、“左眉”实际为他的右眉。以此类推。
•   下文字段均代表一个人脸关键点，包含字段 x: 横坐标位置; y:纵坐标位置  

image.png image.png image.png image.png image.png image.png image.png image.png