Liveness Session Operations - Create Liveness With Verify Session With Verify Image

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

확인을 사용하여 새 활동성 세션을 만듭니다. 세션을 만드는 동안 확인 이미지를 제공합니다.
세션은 개발자가 리소스에 대한 모든 액세스 권한을 부여하지 않고 활동성 검색만 수행하도록 클라이언트 디바이스에 권한을 부여하려는 클라이언트 디바이스 시나리오에 가장 적합합니다. 만든 세션은 수명이 제한되어 있으며 액세스가 만료되기 전에 클라이언트가 원하는 작업을 수행할 수 있는 권한만 부여합니다.

사용 권한에는 다음이 포함됩니다.

• • 최대 3번의 재시도에 대해 /detectLivenessWithVerify/singleModal을 호출하는 기능입니다.
  • 토큰 수명(10분)입니다.

메모

• • 클라이언트 액세스는 활성도 삭제 및 세션 확인 작업을 사용하여 세션을 삭제하여 취소할 수 있습니다.
  • 결과를 검색하려면 Get Liveness With Verify 세션을 사용합니다.
  • 클라이언트가 리소스에 대해 수행한 개별 요청을 감사하려면 세션 감사 항목 확인을 사용하여 활동성 목록을 사용합니다.

권장 옵션: VerifyImage는 세션을 만드는 동안 제공됩니다.

POST {endpoint}/face/{apiVersion}/detectLivenessWithVerify/singleModal/sessions

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
Parameters	formData	True	string	세션을 만들기 위한 매개 변수입니다.
VerifyImage	formData	True	file	확인할 이미지 스트림입니다. 이 파트의 콘텐츠 처리 헤더 필드에는 파일 이름이 있어야 합니다.
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).

응답

Name	형식	Description
200 OK	CreateLivenessWithVerifySessionResult	성공적인 호출은 클라이언트 디바이스에 대한 세션을 만들고 제한된 목적과 시간 동안 클라이언트 애플리케이션에서 사용할 권한 부여 토큰을 제공합니다.
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

예제

Create LivenessWithVerify Session with VerifyImage

샘플 요청

HTTP

POST {endpoint}/face/v1.2-preview.1/detectLivenessWithVerify/singleModal/sessions

샘플 응답

상태 코드:

200

{
  "sessionId": "b12e033e-bda7-4b83-a211-e721c661f30e",
  "authToken": "eyJhbGciOiJFUzI1NiIsIm",
  "verifyImage": {
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "qualityForRecognition": "high"
  }
}

정의

Name	Description
CreateLivenessWithVerifySessionResult	확인 이미지가 제공된 확인 생성을 사용하여 활동성 세션에 대한 응답입니다.
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
FaceRectangle	얼굴을 찾을 수 있는 사각형입니다.
LivenessWithVerifyImage	확인을 위한 얼굴의 세부 정보입니다.
QualityForRecognition	인식에 대한 이미지 품질을 나타냅니다.

CreateLivenessWithVerifySessionResult

확인 이미지가 제공된 확인 생성을 사용하여 활동성 세션에 대한 응답입니다.

Name	형식	Description
authToken	string	클라이언트 애플리케이션에서 실행되는 Vision SDK에 대한 인증을 제공하는 전달자 토큰입니다. 이 전달자 토큰에는 필요한 작업만 수행할 수 있는 권한이 제한되어 있으며 TTL 시간 후에 만료됩니다. 또한 감사할 수 있습니다.
sessionId	string	만든 세션의 고유 세션 ID입니다. 만든 후 48시간 후에 만료되거나 해당 Session DELETE 작업을 사용하여 더 빨리 삭제될 수 있습니다.
verifyImage	LivenessWithVerifyImage	확인을 위한 얼굴의 세부 정보입니다.

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	사각형의 너비(픽셀)입니다.

LivenessWithVerifyImage

확인을 위한 얼굴의 세부 정보입니다.

Name	형식	Description
faceRectangle	FaceRectangle	비교 이미지의 분류가 만들어진 얼굴 영역입니다.
qualityForRecognition	QualityForRecognition	인식을 위한 얼굴 이미지의 품질입니다.

QualityForRecognition

인식에 대한 이미지 품질을 나타냅니다.

Name	형식	Description
high	string	고품질.
low	string	품질이 낮습니다.
medium	string	중간 품질.