Person Group Operations - Create Large Person Group

서비스:

Azure AI Services

API 버전:

v1.2

사용자 지정 largePersonGroupId, 이름, 선택적 userData 및 recognitionModel을 사용하여 새 큰 사람 그룹을 만듭니다.
큰 사람 그룹은 얼굴 인식 기능을 포함하여 업로드된 사람 데이터를 보관하는 컨테이너입니다. 최대 1,000,000개의 엔터티를 보유할 수 있습니다.

만든 후 "큰 사람 그룹 사람 만들기"를 사용하여 그룹에 사용자를 추가하고 "큰 사람 그룹 학습"을 호출하여 이 그룹을 "큰 사람 그룹에서 식별"할 수 있도록 합니다.

이미지가 저장되지 않습니다. "큰 사람 그룹 삭제" 또는 "큰 사람 그룹 삭제"가 호출될 때까지 사용자의 추출된 얼굴 기능 및 userData만 서버에 저장됩니다.

이 큰 사람 그룹과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 큰 사람 그룹에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 큰 사람 그룹의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다.

메모

• • 무료 계층 구독 할당량: 1,000개의 대규모 사용자 그룹.
  • S0 계층 구독 할당량: 1,000,000개의 대규모 사용자 그룹.

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
apiVersion	path	True	string	API 버전
endpoint	path	True	string (uri)	지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름, 예: https://{resource-name}.cognitiveservices.azure.com).
largePersonGroupId	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-z0-9-_]+$	컨테이너의 ID입니다.

요청 본문

Name	필수	형식	Description
name	True	string minLength: 1 maxLength: 128	사용자 정의 이름, 최대 길이는 128입니다.
recognitionModel		RecognitionModel	이 얼굴 목록과 연결된 'recognitionModel'입니다. 지원되는 'recognitionModel' 값에는 'recognition_01', 'recognition_02, 'recognition_03' 및 'recognition_04'이 포함되었습니다. 기본값은 'recognition_01'입니다. 'recognition_04'은 'recognition_03'에 비해 마스크를 착용한 얼굴의 정확도가 향상되고 전반적인 정확도가 'recognition_01' 및 'recognition_02'에 비해 향상되기 때문에 권장됩니다.
userData		string maxLength: 16384	선택적 사용자 정의 데이터입니다. 길이는 16K를 초과하지 않아야 합니다.

응답

Name	형식	Description
200 OK		요청이 성공했습니다.
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 LargePersonGroup

샘플 요청

HTTP

PUT {endpoint}/face/v1.2/largepersongroups/your_large_person_group_id

{
  "name": "your_large_person_group_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

샘플 응답

상태 코드:

200

정의

Name	Description
CreateCollectionRequest	얼굴 컬렉션을 만들기 위한 모델입니다.
FaceError	오류 개체입니다. Face Service에서 반환된 오류 코드 및 메시지에 대한 포괄적인 세부 정보는 다음 링크를 참조하세요. https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	오류 세부 정보가 포함된 응답입니다.
RecognitionModel	얼굴의 인식 모델입니다.

CreateCollectionRequest

Object

얼굴 컬렉션을 만들기 위한 모델입니다.

Name	형식	Default value	Description
name	string minLength: 1 maxLength: 128		사용자 정의 이름, 최대 길이는 128입니다.
recognitionModel	RecognitionModel	recognition_01	이 얼굴 목록과 연결된 'recognitionModel'입니다. 지원되는 'recognitionModel' 값에는 'recognition_01', 'recognition_02, 'recognition_03' 및 'recognition_04'이 포함되었습니다. 기본값은 'recognition_01'입니다. 'recognition_04'은 'recognition_03'에 비해 마스크를 착용한 얼굴의 정확도가 향상되고 전반적인 정확도가 'recognition_01' 및 'recognition_02'에 비해 향상되기 때문에 권장됩니다.
userData	string maxLength: 16384		선택적 사용자 정의 데이터입니다. 길이는 16K를 초과하지 않아야 합니다.

FaceError

Object

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

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

FaceErrorResponse

Object

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

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

RecognitionModel

열거형

얼굴의 인식 모델입니다.

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