人臉
人臉（Face）在人臉識別技術(shù)中特指圖像中發(fā)現(xiàn)的人臉，當對一張圖片進行人臉檢測時，會將檢測到的人臉記錄下來，包括人臉在圖片中的位置，用一個系統(tǒng)標識face_token來表示。注意：對同一張圖片進行多次人臉檢測，對同一個人臉會得到不同的face_token。
人臉集合
人臉集合（FaceSet）是用來存儲檢測到人臉的存儲對象。一個FaceSet內(nèi)face_token是不重復的。
人臉比對/人臉搜索
計算機檢測到圖片中一個人臉之后，通過人臉判斷人身份的過程被稱為人臉比對/人臉搜索。
人臉比對指采集新的人臉，與一個已知身份用戶的人臉進行比對，判斷新的人臉是否屬于該已知身份用戶。人臉比對需要調(diào)用Compare API。
人臉搜索是指采集用戶新的人臉，在多個已知身份用戶的人臉集合中進行搜索，找出新的人臉屬于哪一個已知身份用戶。人臉搜索需要調(diào)用Search API。
API調(diào)用——原理
Face++ 人工智能開放平臺 API是HTTP API。常用的編程語言都能發(fā)起HTTP請求（通過第三方庫或自帶API），使用者向我們的服務器發(fā)起HTTP請求，并加上合適的參數(shù)，服務器將會對請求進行處理，得到結(jié)果將會返回給使用者。
API調(diào)用——鑒權(quán)
帳號下每創(chuàng)建一個應用就會生成一組對應的 api_key 和 api_secret，用以識別用戶是否有權(quán)限調(diào)用 API，所有的API調(diào)用必須提供對應的一組 api_key 和 api_secret 參數(shù)。
API調(diào)用——參數(shù)
調(diào)用每個API需要根據(jù)需求傳不同的參數(shù)，每個API參數(shù)的詳細定義請查看 人臉識別 。所有 API 的調(diào)用都要使用 POST 請求，用戶可以以 Query String 的形式將參數(shù)寫進請求體中，傳圖片文件參數(shù)時則需要在請求體中使用 multipart/form-data 格式來編碼。
API調(diào)用——提示
為了避免因網(wǎng)絡問題而靠成的阻塞，建議將 API 調(diào)用放進異步線程里執(zhí)行。
人臉檢測
描述
調(diào)用者提供圖片文件或者圖片URL，進行人臉檢測和人臉分析。識別出的人臉會給出face_token，用于后續(xù)的人臉比對等操作。請注意，只對人臉包圍盒面積最大的5個人臉進行分析，其他人臉可以使用Face Analyze API進行分析。如果您需要使用檢測出的人臉于后續(xù)操作，建議將對應face_token添加到FaceSet中。如果一個face_token連續(xù)72小時沒有存放在任意FaceSet中，則該face_token將會失效。如果對同一張圖片進行多次人臉檢測，同一個人臉得到的face_token是不同的。
圖片要求
圖片格式：JPG(JPEG)，PNG圖片像素尺寸：最小4848像素，最大40964096像素圖片文件大?。?MB最小人臉像素尺寸： 系統(tǒng)能夠檢測到的人臉框為一個正方形，正方形邊長的最小值為圖像短邊長度的48分之一，最小值不低于48像素。 例如圖片為 40963200 像素，則最小人臉像素尺寸為 6666 像素。
更新日志
2017年6月7日：算法重大升級；提供表情識別 emotion。
2017年3月28日：支持base64編碼的圖片。
2017年3月9日：人臉檢測算法升級；提供了眼睛狀態(tài)檢測eyestatus，替換是否戴眼鏡 glass 的檢測；人臉模糊檢測升級；提供了人種檢測。
調(diào)用URL
https://api-cn.faceplusplus.com/facepp/v3/detect
調(diào)用方法: POST
人臉對比
描述
將兩個人臉進行比對，來判斷是否為同一個人。支持傳兩張圖片進行比對，或者一張圖片與一個已知的face_token比對，也支持兩個face_token進行比對。使用圖片進行比對時會選取圖片中檢測到人臉尺寸最大的一個人臉。
圖片要求
圖片格式：JPG(JPEG)，PNG圖片像素尺寸：最小4848像素，最大40964096像素圖片文件大?。?MB最小人臉像素尺寸： 系統(tǒng)能夠檢測到的人臉框為一個正方形，正方形邊長的最小值為150像素。
更新日志
2017年3月28日：支持base64編碼的圖片。
調(diào)用URL
https://api-cn.faceplusplus.com/facepp/v3/compare
調(diào)用方法: POST
人臉檢索
描述
在Faceset中找出與目標人臉最相似的一張或多張人臉。支持傳入face_token或者直接傳入圖片進行人臉搜索。使用圖片進行比對時會選取圖片中檢測到人臉尺寸最大的一個人臉。
圖片要求
圖片格式：JPG(JPEG)，PNG圖片像素尺寸：最小4848像素，最大40964096像素圖片文件大?。?MB最小人臉像素尺寸： 系統(tǒng)能夠檢測到的人臉框為一個正方形，正方形邊長的最小值為150像素。
更新日志
2017年3月28日：支持base64編碼的圖片。
調(diào)用URL
https://api-cn.faceplusplus.com/facepp/v3/search
調(diào)用方法: POST
臉關鍵點Landmark說明
Landmark對象結(jié)構(gòu)
分別包括臉部，眼睛，眉毛，嘴唇，鼻子輪廓。下圖為示例，綠點為Landmark關鍵點。
Landmark字段說明：
? 下文提及的坐標單位均為像素。
? 下文提及的“左”或“右”，均指圖像中的左右，對于人臉照來說，是反向的。比如：下文提到的“左眼”實際為他的右眼、“左眉”實際為他的右眉。以此類推。
? 下文字段均代表一個人臉關鍵點，包含字段 x: 橫坐標位置; y:縱坐標位置
