Face Recognition Operations - Verify Face To Face

서비스:

Azure AI Services

API 버전:

v1.2-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	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

보안

Ocp-Apim-Subscription-Key

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

형식: apiKey
In(다음 안에): header

AADToken

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: accessCode
권한 부여 URL: https://api.example.com/oauth2/authorize
토큰 URL: https://api.example.com/oauth2/token

범위

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

정의

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

FaceError

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

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

FaceErrorResponse

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

Name	형식	Description
error	FaceError	오류 개체입니다.

VerificationResult

결과를 확인합니다.

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