計(jì)算機(jī)檢測(cè)到圖片中一個(gè)人臉之后，通過(guò)人臉判斷人身份的過(guò)程被稱為人臉比對(duì)/人臉?biāo)阉鳌?/p>

人臉比對(duì)指采集新的人臉，與一個(gè)已知身份用戶的人臉進(jìn)行比對(duì)，判斷新的人臉是否屬于該已知身份用戶。人臉比對(duì)需要調(diào)用Compare API。

人臉?biāo)阉魇侵覆杉脩粜碌娜四?，在多個(gè)已知身份用戶的人臉集合中進(jìn)行搜索，找出新的人臉屬于哪一個(gè)已知身份用戶。人臉?biāo)阉餍枰{(diào)用Search API。

API調(diào)用——原理

Face++ 人工智能開(kāi)放平臺(tái) API是HTTP API。常用的編程語(yǔ)言都能發(fā)起HTTP請(qǐng)求（通過(guò)第三方庫(kù)或自帶API），使用者向我們的服務(wù)器發(fā)起HTTP請(qǐng)求，并加上合適的參數(shù)，服務(wù)器將會(huì)對(duì)請(qǐng)求進(jìn)行處理，得到結(jié)果將會(huì)返回給使用者。

API調(diào)用——鑒權(quán)
帳號(hào)下每創(chuàng)建一個(gè)應(yīng)用就會(huì)生成一組對(duì)應(yīng)的 api_key 和 api_secret，用以識(shí)別用戶是否有權(quán)限調(diào)用 API，所有的API調(diào)用必須提供對(duì)應(yīng)的一組 api_key 和 api_secret 參數(shù)。

API調(diào)用——參數(shù)
調(diào)用每個(gè)API需要根據(jù)需求傳不同的參數(shù)，每個(gè)API參數(shù)的詳細(xì)定義請(qǐng)查看 人臉識(shí)別 。所有 API 的調(diào)用都要使用 POST 請(qǐng)求，用戶可以以 Query String 的形式將參數(shù)寫進(jìn)請(qǐng)求體中，傳圖片文件參數(shù)時(shí)則需要在請(qǐng)求體中使用 multipart/form-data 格式來(lái)編碼。

API調(diào)用——提示
為了避免因網(wǎng)絡(luò)問(wèn)題而靠成的阻塞，建議將 API 調(diào)用放進(jìn)異步線程里執(zhí)行。

人臉檢測(cè)

描述

調(diào)用者提供圖片文件或者圖片URL，進(jìn)行人臉檢測(cè)和人臉?lè)治觥ＷR(shí)別出的人臉會(huì)給出face_token，用于后續(xù)的人臉比對(duì)等操作。請(qǐng)注意，只對(duì)人臉包圍盒面積最大的5個(gè)人臉進(jìn)行分析，其他人臉可以使用Face Analyze API進(jìn)行分析。如果您需要使用檢測(cè)出的人臉于后續(xù)操作，建議將對(duì)應(yīng)face_token添加到FaceSet中。如果一個(gè)face_token連續(xù)72小時(shí)沒(méi)有存放在任意FaceSet中，則該face_token將會(huì)失效。如果對(duì)同一張圖片進(jìn)行多次人臉檢測(cè)，同一個(gè)人臉得到的face_token是不同的。

圖片要求

圖片格式：JPG(JPEG)，PNG圖片像素尺寸：最小4848像素，最大40964096像素圖片文件大小：2MB最小人臉像素尺寸： 系統(tǒng)能夠檢測(cè)到的人臉框?yàn)橐粋€(gè)正方形，正方形邊長(zhǎng)的最小值為圖像短邊長(zhǎng)度的48分之一，最小值不低于48像素。 例如圖片為 40963200 像素，則最小人臉像素尺寸為 6666 像素。

更新日志

2017年6月7日：算法重大升級(jí)；提供表情識(shí)別 emotion。
2017年3月28日：支持base64編碼的圖片。
2017年3月9日：人臉檢測(cè)算法升級(jí)；提供了眼睛狀態(tài)檢測(cè)eyestatus，替換是否戴眼鏡 glass 的檢測(cè)；人臉模糊檢測(cè)升級(jí)；提供了人種檢測(cè)。

調(diào)用URL
https://api-cn.faceplusplus.com/facepp/v3/detect

調(diào)用方法: POST

人臉對(duì)比

描述

將兩個(gè)人臉進(jìn)行比對(duì)，來(lái)判斷是否為同一個(gè)人。支持傳兩張圖片進(jìn)行比對(duì)，或者一張圖片與一個(gè)已知的face_token比對(duì)，也支持兩個(gè)face_token進(jìn)行比對(duì)。使用圖片進(jìn)行比對(duì)時(shí)會(huì)選取圖片中檢測(cè)到人臉尺寸最大的一個(gè)人臉。

圖片要求

圖片格式：JPG(JPEG)，PNG圖片像素尺寸：最小4848像素，最大40964096像素圖片文件大小：2MB最小人臉像素尺寸： 系統(tǒng)能夠檢測(cè)到的人臉框?yàn)橐粋€(gè)正方形，正方形邊長(zhǎng)的最小值為150像素。

更新日志

2017年3月28日：支持base64編碼的圖片。

調(diào)用URL
https://api-cn.faceplusplus.com/facepp/v3/compare

調(diào)用方法: POST

人臉檢索

描述

在Faceset中找出與目標(biāo)人臉最相似的一張或多張人臉。支持傳入face_token或者直接傳入圖片進(jìn)行人臉?biāo)阉?。使用圖片進(jìn)行比對(duì)時(shí)會(huì)選取圖片中檢測(cè)到人臉尺寸最大的一個(gè)人臉。

圖片要求

圖片格式：JPG(JPEG)，PNG圖片像素尺寸：最小4848像素，最大40964096像素圖片文件大小：2MB最小人臉像素尺寸： 系統(tǒng)能夠檢測(cè)到的人臉框?yàn)橐粋€(gè)正方形，正方形邊長(zhǎng)的最小值為150像素。

更新日志

2017年3月28日：支持base64編碼的圖片。

調(diào)用URL
https://api-cn.faceplusplus.com/facepp/v3/search

調(diào)用方法: POST

臉關(guān)鍵點(diǎn)Landmark說(shuō)明

Landmark對(duì)象結(jié)構(gòu)
分別包括臉部，眼睛，眉毛，嘴唇，鼻子輪廓。下圖為示例，綠點(diǎn)為L(zhǎng)andmark關(guān)鍵點(diǎn)。

Landmark字段說(shuō)明：

?   下文提及的坐標(biāo)單位均為像素。
?   下文提及的“左”或“右”，均指圖像中的左右，對(duì)于人臉照來(lái)說(shuō)，是反向的。比如：下文提到的“左眼”實(shí)際為他的右眼、“左眉”實(shí)際為他的右眉。以此類推。
?   下文字段均代表一個(gè)人臉關(guān)鍵點(diǎn)，包含字段 x: 橫坐標(biāo)位置; y:縱坐標(biāo)位置  

image.png

image.png

image.png

image.png

image.png

image.png

image.png

image.png