다음을 통해 공유

Person Group Operations - Create Person Group

  • 참조
서비스:
Azure AI Services
API 버전:
v1.2-preview.1

지정된 personGroupId, 이름, 사용자가 제공한 userData 및 recognitionModel을 사용하여 새 인물 그룹을 만듭니다.
개인 그룹은 얼굴 인식 기능을 포함하여 업로드된 사람 데이터를 보관하는 컨테이너입니다.

만든 후에는 "사람 그룹 사람 만들기"를 사용하여 그룹에 사용자를 추가한 다음 "개인 그룹 학습"을 호출하여 이 그룹이 "사람 그룹에서 식별"되도록 준비합니다.

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

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

메모

    • 무료 계층 구독 할당량: 1,000인 그룹. 각 인원은 최대 1,000명을 수용합니다.
    • S0 계층 구독 할당량: 1,000,000인 그룹. 각 인원은 최대 10,000명을 수용합니다.
    • 더 큰 규모의 얼굴 식별 문제를 처리하려면 큰 사람 그룹을 사용하는 것이 좋습니다.
PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

URI 매개 변수

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

string

API 버전
endpoint
 path True

string

uri

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

string

컨테이너의 ID입니다.

regex 패턴: ^[a-z0-9-_]+$

요청 본문

Name 필수 형식 Description
name True

string

사용자 정의 이름, 최대 길이는 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

선택적 사용자 정의 데이터입니다. 길이는 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 PersonGroup

샘플 요청

PUT {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id

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

샘플 응답

상태 코드:
200

정의

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

오류 개체입니다.