Face Recognition Operations - Verify Face To Face

服務:

Azure AI Services

API 版本:

v1.2-preview.1

確認兩張臉部是否屬於同一個人。

注意

• • 較高的臉部影像質量意味著更好的識別精確度。 請考慮高品質的臉部：正面、清晰和臉部大小為 200x200 像素（眼睛之間 100 像素）或更大。
  • 對於敏感性精確度的案例，請做出自己的判斷。
  • 與兩個臉部相關聯的 『recognitionModel』 應該相同。

POST {endpoint}/face/{apiVersion}/verify

URI 參數

名稱	位於	必要	類型	Description
apiVersion	path	True	string	API 版本
endpoint	path	True	string uri	支持的認知服務端點（通訊協定和主機名，例如：https://{resource-name}.cognitiveservices.azure.com）。

要求本文

名稱	必要	類型	Description
faceId1	True	string	一張臉部的faceId來自「偵測」。
faceId2	True	string	另一張臉部的faceId來自 「偵測」。

回應

名稱	類型	Description
200 OK	VerificationResult	成功的呼叫會傳回驗證結果。
Other Status Codes	FaceErrorResponse	未預期的錯誤回應。 標題 x-ms-error-code: string

安全性

Ocp-Apim-Subscription-Key

Azure AI 臉部訂用帳戶的秘密密鑰。

類型: apiKey
位於: header

AADToken

Azure Active Directory OAuth2 流程

類型: oauth2
Flow: accessCode
授權 URL: https://api.example.com/oauth2/authorize
權杖 URL: https://api.example.com/oauth2/token

範圍

名稱	Description
https://cognitiveservices.azure.com/.default

範例

Verify Face to Face

範例要求

HTTP

POST {endpoint}/face/v1.2-preview.1/verify

{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "3aa87e30-b380-48eb-ad9e-1aa54fc52bd3"
}

範例回覆

狀態碼:

200

{
  "isIdentical": true,
  "confidence": 0.8
}

定義

名稱	Description
FaceError	error 物件。 如需臉部服務所傳回錯誤碼和訊息的完整詳細數據，請參閱下列連結：https://aka.ms/face-error-codes-and-messages。
FaceErrorResponse	包含錯誤詳細數據的回應。
VerificationResult	確認結果。

FaceError

error 物件。 如需臉部服務所傳回錯誤碼和訊息的完整詳細數據，請參閱下列連結：https://aka.ms/face-error-codes-and-messages。

名稱	類型	Description
code	string	其中一組伺服器定義的錯誤碼。
message	string	錯誤的人類可讀取表示法。

FaceErrorResponse

包含錯誤詳細數據的回應。

名稱	類型	Description
error	FaceError	error 物件。

VerificationResult

確認結果。

名稱	類型	Description
confidence	number	數位表示兩個臉部是否屬於同一個人，或臉部是否屬於該人員， 的相似度信賴度。 根據預設，如果相似度信賴度大於或等於0.5，isIdentical會設定為True。 這適用於進階使用者覆寫 『isIdentical』 並微調自己的數據結果。
isIdentical	boolean	True 是表示 如果兩個臉部屬於同一人或臉部屬於該人員，則為 false。