Liveness Session Operations - Get Liveness Session Result

참조

서비스:: Azure AI Services

API 버전:: v1.2

detectLiveness/singleModal 호출의 세션 결과를 가져옵니다.

GET {endpoint}/face/{apiVersion}/detectLiveness-sessions/{sessionId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).
sessionId	path	True	string	이 세션을 참조할 고유 ID입니다.

응답

Name	형식	Description
200 OK	LivenessSession	요청이 성공했습니다.
Other Status Codes	FaceErrorResponse	예기치 않은 오류 응답입니다. 헤더 x-ms-error-code: string

Name

형식

Description

200 OK

LivenessSession

요청이 성공했습니다.

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

예제

Get LivenessSession Result

샘플 요청

HTTP

GET {endpoint}/face/v1.2/detectLiveness-sessions/b12e033e-bda7-4b83-a211-e721c661f30e

샘플 응답

상태 코드:: 200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "status": "NotStarted",
  "modelVersion": "2024-11-15",
  "results": {
    "attempts": [
      {
        "attemptId": 2,
        "attemptStatus": "Succeeded",
        "result": {
          "livenessDecision": "realface",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          },
          "digest": "B0A803BB7B26F3C8F29CD36030F8E63ED3FAF955FEEF8E01C88AB8FD89CCF761",
          "sessionImageId": "Ae3PVWlXAmVAnXgkAFt1QSjGUWONKzWiSr2iPh9p9G4I"
        }
      },
      {
        "attemptId": 1,
        "attemptStatus": "Failed",
        "error": {
          "code": "FaceWithMaskDetected",
          "message": "Mask detected on face image.",
          "targets": {
            "color": {
              "faceRectangle": {
                "top": 669,
                "left": 203,
                "width": 646,
                "height": 724
              }
            }
          }
        }
      }
    ]
  }
}

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
FaceRectangle	얼굴을 찾을 수 있는 사각형입니다.
LivenessColorDecisionTarget	활동성 분류에 사용되는 색 이미지의 대상입니다.
LivenessDecision	활동성 분류의 결과입니다.
LivenessDecisionTargets	활동성 분류에 사용되는 대상입니다.
LivenessError	활동성 분류의 오류입니다.
LivenessModel	활동성 분류에 사용되는 모델 버전입니다.
LivenessResult	활동성 분류의 결과입니다.
LivenessSession	활동성 검색의 세션 결과입니다.
LivenessSessionAttempt	활동성 세션 시도입니다.
LivenessSessionResults	활동 세션의 결과입니다.
OperationState	세션의 현재 상태입니다.

FaceError

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

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

FaceErrorResponse

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

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

FaceRectangle

얼굴을 찾을 수 있는 사각형입니다.

Name	형식	Description
height	integer	사각형의 높이(픽셀)입니다.
left	integer	이미지가 사각형의 왼쪽 가장자리까지인 경우 왼쪽 가장자리로부터의 거리(픽셀)입니다.
top	integer	이미지가 사각형의 위쪽 가장자리까지의 경우 위쪽 가장자리와의 거리(픽셀)입니다.
width	integer	사각형의 너비(픽셀)입니다.

LivenessColorDecisionTarget

활동성 분류에 사용되는 색 이미지의 대상입니다.

Name	형식	Description
faceRectangle	FaceRectangle	활동성 분류가 이루어진 얼굴 영역입니다.

LivenessDecision

활동성 분류의 결과입니다.

Name	형식	Description
realface	string	알고리즘은 대상 얼굴을 실제 얼굴로 분류했습니다.
spoofface	string	알고리즘은 대상 얼굴을 스푸핑으로 분류했습니다.
uncertain	string	알고리즘은 대상 얼굴을 실제 또는 스푸핑으로 분류할 수 없습니다.

LivenessDecisionTargets

활동성 분류에 사용되는 대상입니다.

Name	형식	Description
color	LivenessColorDecisionTarget	활동성 분류에 사용되는 색 이미지의 대상입니다.

LivenessError

활동성 분류의 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.
targets	LivenessDecisionTargets	활동성 분류에 사용되는 대상입니다.

LivenessModel

활동성 분류에 사용되는 모델 버전입니다.

Name	형식	Description
2024-11-15	string

LivenessResult

활동성 분류의 결과입니다.

Name	형식	Description
digest	string	이 요청에 대한 서버 계산 다이제스트입니다. 보고된 클라이언트 다이제스트가 서버 계산 다이제스트와 다른 경우 클라이언트와 서비스 간의 메시지 무결성이 손상되어 결과를 신뢰할 수 없습니다. 자세한 내용은 이 값을 활용하여 엔드 투 엔드 솔루션을 보호하는 방법에 대한 가이드를 참조하세요.
livenessDecision	LivenessDecision	대상 얼굴의 활동성 분류입니다.
sessionImageId	string	세션 요청의 이미지 ID입니다.
targets	LivenessDecisionTargets	활동성 분류에 사용되는 대상입니다.