Face List Operations - Get Large Face List

서비스:

Azure AI Services

API 버전:

v1.2-preview.1

큰 얼굴 목록의 largeFaceListId, 이름, userData 및 recognitionModel을 검색합니다.

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

선택적 매개 변수:

GET {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}?returnRecognitionModel={returnRecognitionModel}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string uri	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).
largeFaceListId	path	True	string	유효한 문자는 소문자 또는 숫자 또는 '-' 또는 '_'의 문자이며 최대 길이는 64입니다. regex 패턴: ^[a-z0-9-_]+$
returnRecognitionModel	query		boolean	'recognitionModel'을 반환합니다. 기본값은 false입니다.

응답

Name	형식	Description
200 OK	LargeFaceList	호출이 성공하면 큰 얼굴 목록의 정보가 반환됩니다.
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 LargeFaceList

샘플 요청

HTTP

GET {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id?returnRecognitionModel=True

샘플 응답

상태 코드:

200

{
  "name": "your_large_face_list_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01",
  "largeFaceListId": "your_large_face_list_id"
}

정의

Name	Description
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
LargeFaceList	큰 얼굴 목록은 최대 1,000,000개의 얼굴 목록입니다.
RecognitionModel	얼굴의 인식 모델입니다.

FaceError

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

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

FaceErrorResponse

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

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

LargeFaceList

큰 얼굴 목록은 최대 1,000,000개의 얼굴 목록입니다.

Name	형식	Description
largeFaceListId	string	유효한 문자는 소문자 또는 숫자 또는 '-' 또는 '_'의 문자이며 최대 길이는 64입니다.
name	string	사용자 정의 이름, 최대 길이는 128입니다.
recognitionModel	RecognitionModel	인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceIds와 연결할 때 사용됩니다.
userData	string	선택적 사용자 정의 데이터입니다. 길이는 16K를 초과하지 않아야 합니다.

RecognitionModel

얼굴의 인식 모델입니다.

Name	형식	Description
recognition_01	string	"Detect"의 기본 인식 모델입니다. 2019년 3월 이전에 만든 모든 faceId는 이 인식 모델과 결합됩니다.
recognition_02	string	인식 모델은 2019년 3월에 출시되었습니다.
recognition_03	string	인식 모델은 2020년 5월에 출시됩니다.
recognition_04	string	인식 모델은 2021년 2월에 출시되었습니다. 더 나은 인식 정확도를 위해 이 인식 모델을 사용하는 것이 좋습니다.