Face Recognition Operations - Verify Face To Face

Service:

Azure AI Services

API Version:

v1.1-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來自 「Detect」。。

回應

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

安全性

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Azure Active Directory OAuth2 流程

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

範例

Verify Face to Face

Sample Request

HTTP

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

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

Sample Response

Status code:

200

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

定義

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

FaceError

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

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

FaceErrorResponse

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

名稱	類型	Description
error	FaceError	錯誤物件。

VerificationResult

驗證結果。

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