Large Person Group - Create

사용자 지정 largePersonGroupId, 이름, 선택적 userData 및 recognitionModel을 사용하여 새 큰 사람 그룹을 만듭니다.
큰 사람 그룹은 얼굴 인식 기능 및 최대 1,000,000명의 사용자를 포함하여 업로드된 사람 데이터의 컨테이너입니다.
만든 후 LargePersonGroup Person - Create 를 사용하여 그룹에 사용자를 추가하고 LargePersonGroup - Train 을 호출하여 이 그룹을 Face - 식별에 대해 준비합니다.
이미지가 저장되지 않습니다. LargePersonGroup Person - Delete 또는 LargePersonGroup -Delete가 호출될 때까지 사용자의 추출된 얼굴 기능 및 userData만 서버에 저장됩니다.
이 큰 사용자 그룹과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 큰 사람 그룹에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 대규모 사용자 그룹의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다. 얼굴 인식 모델 지정을 참조하세요.

대규모 사용자 그룹 할당량:

  • 무료 계층 구독 할당량: 1,000개의 대규모 사용자 그룹.
  • S0 계층 구독 할당량: 1,000,000개의 대규모 사용자 그룹
PUT {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}

URI 매개 변수

Name In Required Type Description
Endpoint
path True
  • string

지원되는 Cognitive Services 엔드포인트(프로토콜 및 호스트 이름( 예: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

특정 큰 사용자 그룹을 참조하는 ID입니다.

Regex pattern: ^[a-z0-9-_]+$

요청 헤더

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

요청 본문

Name Required Type Description
name True
  • string

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

recognitionModel

인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceIds, (Large)FaceList 또는 (Large)PersonGroup과 연결할 때 사용됩니다. Face - Detect 또는 (Large)FaceList - Create or (Large)PersonGroup - Create를 수행할 때 인식 모델 이름을 제공할 수 있습니다. 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 필요한 모델을 명시적으로 지정하세요.

userData
  • string

사용자가 지정한 데이터입니다. 길이는 16KB를 초과하면 안 됩니다.

응답

Name Type Description
200 OK

호출이 성공하면 빈 응답 본문이 반환됩니다.

Other Status Codes

오류 응답입니다.

보안

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

예제

Create new large person group example

Sample Request

PUT {Endpoint}/face/v1.0/largepersongroups/abc


{
  "name": "large-person-group-name",
  "userData": "User-provided data attached to the large person group.",
  "recognitionModel": "recognition_01"
}

Sample Response

정의

APIError

API에서 반환된 오류 정보

Error

오류 본문입니다.

MetaDataContract

largePersonGroup/personGroup 및 largeFaceList/faceList의 사용자 정의 이름과 사용자 지정 데이터 및 인식 모델 이름의 조합입니다.

RecognitionModel

인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceIds, (Large)FaceList 또는 (Large)PersonGroup과 연결할 때 사용됩니다. Face - Detect 또는 (Large)FaceList - Create or (Large)PersonGroup - Create를 수행할 때 인식 모델 이름을 제공할 수 있습니다. 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 필요한 모델을 명시적으로 지정하세요.

APIError

API에서 반환된 오류 정보

Name Type Description
error

오류 본문입니다.

Error

오류 본문입니다.

Name Type Description
code
  • string
message
  • string

MetaDataContract

largePersonGroup/personGroup 및 largeFaceList/faceList의 사용자 정의 이름과 사용자 지정 데이터 및 인식 모델 이름의 조합입니다.

Name Type Default Value Description
name
  • string

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

recognitionModel recognition_01

인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceIds, (Large)FaceList 또는 (Large)PersonGroup과 연결할 때 사용됩니다. Face - Detect 또는 (Large)FaceList - Create or (Large)PersonGroup - Create를 수행할 때 인식 모델 이름을 제공할 수 있습니다. 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 필요한 모델을 명시적으로 지정하세요.

userData
  • string

사용자가 지정한 데이터입니다. 길이는 16KB를 초과하면 안 됩니다.

RecognitionModel

인식 모델의 이름입니다. 인식 모델은 얼굴 기능을 추출하고 감지된 faceIds, (Large)FaceList 또는 (Large)PersonGroup과 연결할 때 사용됩니다. Face - Detect 또는 (Large)FaceList - Create or (Large)PersonGroup - Create를 수행할 때 인식 모델 이름을 제공할 수 있습니다. 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 필요한 모델을 명시적으로 지정하세요.

Name Type Description
recognition_01
  • string
recognition_02
  • string
recognition_03
  • string
recognition_04
  • string