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 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름: https://{resource-name}.cognitiveservices.azure.com).

요청 본문

Name	필수	형식	Description
faceId1	True	string	한 얼굴의 faceId는 "Detect"에서 가져옵니다.
faceId2	True	string	다른 얼굴의 faceId는 "Detect"에서 가져옵니다.

응답

Name	형식	Description
200 OK	VerificationResult	호출이 성공하면 확인 결과가 반환됩니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. Headers x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

Azure AI Face 구독의 비밀 키입니다.

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

Name	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
}

정의

Name	Description
FaceError	Error 개체. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 링크를 https://aka.ms/face-error-codes-and-messages참조하세요.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
VerificationResult	결과를 확인합니다.

FaceError

Error 개체. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 링크를 https://aka.ms/face-error-codes-and-messages참조하세요.

Name	형식	Description
code	string	서버 정의 오류 코드 집합 중 하나입니다.
message	string	사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

오류 세부 정보가 포함된 응답입니다.

Name	형식	Description
error	FaceError	Error 개체.

VerificationResult

결과를 확인합니다.

Name	형식	Description
confidence	number	숫자는 두 얼굴이 같은 사람에 속하는지 또는 얼굴이 그 사람에게 속하는지 여부에 대한 유사성을 나타냅니다. 유사성 신뢰도가 0.5보다 크거나 같으면 기본적으로 isIdentical이 True로 설정됩니다. 이 기능은 고급 사용자가 'isIdentical'을 재정의하고 자체 데이터에서 결과를 미세 조정하는 데 유용합니다.
isIdentical	boolean	True이면 두 얼굴이 같은 사람에 속하거나 얼굴이 그 사람에게 속하고, 그렇지 않으면 false입니다.