다음을 통해 공유


Person Group Operations - Get Large Person Groups

기존의 모든 큰 사람 그룹'largePersonGroupId, 이름, userData 및 recognitionModel을 나열합니다.
큰 사람 그룹 largePersonGroupId의 사전순으로 저장됩니다.

    • "start" 매개 변수(문자열, 선택 사항)는 반환된 항목이 문자열 비교에 따라 더 큰 ID를 가질 ID 값을 지정합니다. "start"를 빈 값으로 설정하면 첫 번째 항목부터 항목을 반환해야 합니다.
    • "top" 매개 변수(int, 선택 사항)는 반환할 최대 항목 수를 결정하며 호출당 최대 1,000개의 항목으로 제한됩니다. 이 제한을 초과하는 추가 항목을 검색하려면 현재 호출에서 반환된 마지막 항목의 personId로 "start"를 지정합니다.

  • 예를 들어 ID가 있는 총 5개의 항목이 있습니다. "itemId1", ..., "itemId5".
    • "start=&top="은 5개 항목을 모두 반환합니다.
    • "start=&top=2"는 "itemId1", "itemId2"를 반환합니다.
    • "start=itemId2&top=3"은 "itemId3", "itemId4", "itemId5"를 반환합니다.
GET {endpoint}/face/{apiVersion}/largepersongroups
GET {endpoint}/face/{apiVersion}/largepersongroups?start={start}&top={top}&returnRecognitionModel={returnRecognitionModel}

URI 매개 변수

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

string

API 버전

endpoint
path True

string

uri

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

returnRecognitionModel
query

boolean

'recognitionModel' 여부를 반환합니다. 기본값은 false입니다.

start
query

string

"start"보다 큰 리소스를 나열합니다. 64자 이하를 포함합니다. 기본값은 비어 있습니다.

top
query

integer

int32

[1, 1000]에 이르는 나열할 항목 수입니다. 기본값은 1000입니다.

응답

Name 형식 Description
200 OK

LargePersonGroup[]

성공적인 호출은 큰 사람 그룹 및 해당 정보(largePersonGroupId, name 및 userData)의 배열을 반환합니다.

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 LargePersonGroups

샘플 요청

GET {endpoint}/face/v1.1-preview.1/largepersongroups?start=00000000-0000-0000-0000-000000000000&top=20&returnRecognitionModel=True

샘플 응답

[
  {
    "name": "your_large_person_group_name",
    "userData": "your_user_data",
    "recognitionModel": "recognition_01",
    "largePersonGroupId": "your_large_person_group_id"
  }
]

정의

Name Description
FaceError

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

FaceErrorResponse

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

LargePersonGroup

얼굴 인식 기능 및 최대 1,000,000명의 사용자를 포함하여 업로드된 사람 데이터의 컨테이너입니다.

RecognitionModel

얼굴에 대한 인식 모델입니다.

FaceError

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

Name 형식 Description
code

string

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

message

string

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

FaceErrorResponse

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

Name 형식 Description
error

FaceError

Error 개체.

LargePersonGroup

얼굴 인식 기능 및 최대 1,000,000명의 사용자를 포함하여 업로드된 사람 데이터의 컨테이너입니다.

Name 형식 Description
largePersonGroupId

string

컨테이너의 ID입니다.

name

string

사용자 정의 이름, 최대 길이는 128입니다.

recognitionModel

RecognitionModel

인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceId와 연결할 때 사용됩니다.

userData

string

선택적 사용자 정의 데이터입니다. 길이가 16K를 초과하면 안 됩니다.

RecognitionModel

얼굴에 대한 인식 모델입니다.

Name 형식 Description
recognition_01

string

"검색"의 기본 인식 모델입니다. 2019년 3월 이전에 만든 모든 faceId는 이 인식 모델과 결합됩니다.

recognition_02

string

인식 모델은 2019년 3월에 출시되었습니다.

recognition_03

string

인식 모델은 2020년 5월에 출시되었습니다.

recognition_04

string

인식 모델은 2021년 2월에 출시되었습니다. 더 나은 인식 정확도를 위해 이 인식 모델을 사용하는 것이 좋습니다.