다음을 통해 공유


Liveness Session Operations - Get Session Image

활동성 세션 중에 저장된 세션 이미지를 가져옵니다.

GET {endpoint}/face/{apiVersion}/session/sessionImages/{sessionImageId}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
apiVersion
path True

string

API 버전

endpoint
path True

string

uri

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).

sessionImageId
path True

string

검색할 이미지의 요청 ID입니다.

응답

Name 형식 Description
200 OK

file

요청이 성공했습니다.

Media Types: "application/octet-stream", "application/json"

Other Status Codes

FaceErrorResponse

예기치 않은 오류 응답입니다.

Media Types: "application/octet-stream", "application/json"

헤더

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 Session Image

샘플 요청

GET {endpoint}/face/v1.2-preview.1/session/sessionImages/3d035d35-2e01-4ed4-8935-577afde9caaa

샘플 응답

"<session-image-bytes>"

정의

Name Description
FaceError

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

FaceErrorResponse

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

FaceError

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

Name 형식 Description
code

string

서버에서 정의한 오류 코드 집합 중 하나입니다.

message

string

사람이 읽을 수 있는 오류 표현입니다.

FaceErrorResponse

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

Name 형식 Description
error

FaceError

오류 개체입니다.