人臉比對服務

適用情境應用：會員/員工臉部驗證、黑/白名單人員辨識。

應用場域

會員

線上課程學員認證

透過特定人臉比對辨識功能，預先匯入學員資訊與學員照片，經由查找人臉功能，快速確認線上課程學員與資料庫學員是否匹配。
會員驗證

資安多重身份認證

傳統帳號密碼外洩，容易造稱機敏資料外洩的資安疑慮，可透過臉部辨識系統，確認帳號密碼登入的使用者是否為相匹配員工。

人臉比對功能簡介

人臉比對服務可透過API [“add_face”] 建立專屬人臉資料庫，當資料庫建立後，透過API [“find_face”] 輸入人臉， 即能比對是否為專屬人臉資料庫中的人臉。

AI人臉比對可透過API判別指定人物
透過API判別指定人物

新增人臉至比對資料庫

透過 [“add_face”] 將人臉資訊建立至專屬資料庫，建立完成後，系統將回應該圖片中所有人臉位置以及特徵編號，人臉特徵編號為唯一碼，可用於會員識別、白/黑名單人臉辨識、員工識別等；當匯入照片中有多張人臉時，可透過回傳位置來確認人臉對應之唯一碼。

❖注意：為保護個資安全，本系統不儲存人臉照片，辨識後的序號與實際關聯使用者建議建檔牢記。

HTTP方法與請求網址：

POST https://saas.intemotech.com/saasapi/detect

Content-type

application/form-data

請求from-data正文：

KEYVALUE
file匯入照片檔案 (image)
api_name[“add_face”] (string)

cURL：

curl --location --request POST 'https://saas.intemotech.com/saasapi/detect' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'api_name="[\"add_face\"]"' \
--form 'file=@"/xxxx.png"'

辨識結果文本：

{
    "data": [
        {
            "add_face": [
                {
                    "point": {
                        "bottom": 182,
                        "face_id": "17",
                        "left": 124,
                        "right": 253,
                        "top": 53
                    }
                }
            ]
        }
    ],
    "states": "Sucessfully"
}
欄位名稱欄位說明
point臉部資訊(包含位置、 唯一碼人臉ID)
bottom人臉底部位置
left人臉左方位置
right人臉右方位置
top人臉上方位置
face_id人臉特徵ID，可做為確認人臉時的唯一值
states新增人臉成功、失敗
回傳欄位說明

比對資料庫人臉

透過 [“find_face”] API將單一張人臉資訊傳送至iSeek平台，平台會比對使用 [“add_face”] 中所建立的人臉資料庫中，最相近的人臉前五名，並依照信心值由0.0~1.0排序(越接近0表示越相似)。

HTTP方法與請求網址：

POST https://saas.intemotech.com/saasapi/detect

Content-type

application/form-data

請求from-data正文：

KEYVALUE
file匯入照片檔案，支援格式：JPG,PNG,JPEG (image)
api_name[“find_face”] (string)

cURL：

curl --location --request POST 'https://saas.intemotech.com/saasapi/detect' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'api_name="[\"add_face\"]"' \
--form 'file=@"/xxxx.png"'

辨識回覆文本：

{
    "data": [
        {
            "find_face": [
                {
                    "point": {
                        "bottom": 182,
                        "data": [
                            {
                                "id": "17",
                                "p": 0.0
                            },
                            {
                                "id": "15",
                                "p": 0.611513889191251
                            },
                            {
                                "id": "14",
                                "p": 0.73373610423555
                            },
                            {
                                "id": "16",
                                "p": 0.742434805975746
                            }
                        ],
                        "left": 124,
                        "right": 253,
                        "top": 53
                    }
                }
            ]
        }
    ],
    "states": "Sucessfully"
}
欄位名稱欄位說明
point臉部資訊(包含辨識位置、 辨識結果)
bottom人臉底部位置
left人臉左方位置
right人臉右方位置
top人臉上方位置
data該位置人臉比對結果
id資料庫人臉編號
p與上述編號相似程度，分數級距從0.0到1.0，分數越接近0表示越相近
states新增人臉成功、失敗
回傳欄位說明

刪除資料庫人臉

當要刪除資料庫中特定人臉時，可透過 [“del_face”] API指定ID將人臉刪除。

HTTP方法與請求網址：

DELETE https://saas.intemotech.com/saasapi/detect

Content-type

application/form-data

請求from-data正文：

KEYVALUE
file刪除face ID(array)
api_namedel_faces (string)

cURL：

curl --location -g --request DELETE curl --location --request DELETE 'https://saas.intemotech.com/saasapi/detect' \
--header 'Authorization: Bearer <TOKEN>' \
--form 'value="[face ID-1, face ID-2,...]"' \
--form 'api_name="del_faces"'

辨識回覆文本：

{
    "data": [
        {
            "del_faces": {
                "msg": [
                    "del:14",
                    "del:15"
                ]
            }
        }
    ],
    "states": "Sucessfully"
}
欄位名稱欄位說明
del_face刪除人臉
msg刪除人臉列表
del刪除人臉ID
states回應成功、失敗
回傳欄位說明