人臉辨識服務
適用情境應用：顧客分析、人種分析、年齡性別歸類。
文檔索引
應用場域
人臉辨識API使用方式
當想知道使用者的臉部資訊時(如：年齡、性別、情緒、人種等)，可透過[“face_detection”] 分析得知顧客臉部狀態，藉此紀錄使用者對於某狀態下的反應。
❖注意：辨識結果會因使用者配戴口罩而精準度降低。
傳送人臉至服務識別
透過 [“face_detection”] 將欲判斷的人臉匯入，該API即會回傳：年齡、性別、種族、各情緒判斷結果，系統開發者可依辨識結果做後續系統整合。
HTTP方法與請求網址：
POST https://saas.intemotech.com/saasapi/detectContent-type
application/form-data請求from-data正文：
| KEY | VALUE |
|---|---|
| file | 匯入照片檔案 (image) |
| api_name | [“face_detection”] (string) |
cURL：
curl --location --request POST 'https://saas.intemotech.com/saasapi/detect' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'file=@"/xxx.png"' \
--form 'api_name="[\"face_detection\"]"'辨識結果文本：
{
"data": [
{
"find_person": {
"instance_1": {
"age": 28,
"dominant_emotion": "surprise",
"dominant_race": "white",
"emotion": {
"angry": 0.00045202873479865957,
"disgust": 1.7714682802247306e-10,
"fear": 0.012033889652229846,
"happy": 12.085676938295364,
"neutral": 0.002798511559376493,
"sad": 1.0599006117217868e-06,
"surprise": 87.89904117584229
},
"gender": "Woman",
"race": {
"asian": 1.1787988658224662e-08,
"black": 5.579217766430107e-11,
"indian": 8.331245021154368e-08,
"latino hispanic": 0.004727170944169984,
"middle eastern": 0.007101496276670623,
"white": 99.98817443706685
},
"region": {
"h": 66,
"w": 45,
"x": 141,
"y": 37
}
}
}
}
],
"states": "Sucessfully"
}| 欄位名稱 | 欄位說明 |
|---|---|
| age | 年齡 |
| dominant_emotion | 情緒 |
| dominant_race | 種族 |
| emotion | 情緒列表 |
| angry | 生氣 |
| disgust | 厭惡 |
| fear | 害怕 |
| happy | 開心 |
| neutral | 自然 |
| sad | 難過 |
| surprise | 驚訝 |
| gender | 性別 |
| race | 種族列表 |
| asian | 亞洲人 |
| black | 黑人 |
| indian | 紅種人 |
| latino hispanic | 拉丁裔西班牙裔 |
| middle eastern | 中東 |
| white | 白人 |
| ragion | 人臉位置 |
| h | 高度 |
| w | 寬度 |
| x | 起始點(x軸) |
| y | 起始點(y軸) |