Large Person Group - Create

Vytvořte novou velkou skupinu osob s uživatelem zadaným largePersonGroupId, názvem, volitelným objektem userData a recognitionModel.
Velká skupina osob je kontejner nahraných dat osob, včetně funkce rozpoznávání tváře a až 1 000 000 osob.
Po vytvoření použijte skupinu LargePersonGroup Person – Vytvoření k přidání osoby do skupiny a volání LargePersonGroup – Trénování, abyste tuto skupinu připravili na rozpoznávání tváře .
Nebude uložen žádný obrázek. Na serveru se uloží pouze extrahované funkce tváře a userData, dokud se nevolá funkce LargePersonGroup Person – Delete nebo LargePersonGroup – Delete .
Objekt recognitionModel by měl být zadán pro přidružení k této velké skupině osob. Výchozí hodnota pro "recognitionModel" je "recognition_01", pokud je potřeba nejnovější model, explicitně zadejte model, který v tomto parametru potřebujete. Nové tváře přidané do existující velké skupiny osob budou používat model rozpoznávání, který je již přidružený k kolekci. Stávající funkce tváře ve velké skupině osob nelze aktualizovat na funkce extrahované jinou verzí modelu rozpoznávání. Informace o určení modelu rozpoznávání tváře najdete v tématu Určení modelu rozpoznávání tváře.

Kvóta skupiny velkých osob:

  • Kvóta předplatného úrovně Free: 1 000 velkých skupin osob
  • Kvóta předplatného S0 úrovně: 1 000 000 velkých skupin osob.
PUT {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}

Parametry identifikátoru URI

Name In Required Type Description
Endpoint
path True
  • string

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

ID odkazující na konkrétní velkou skupinu osob.

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

Hlavička požadavku

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

Text požadavku

Name Required Type Description
name True
  • string

Uživatelské definované jméno, maximální délka je 128.

recognitionModel

Název modelu rozpoznávání Model rozpoznávání se používá, když se funkce tváře extrahují a přidruží k detekovaným faceId, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění rozpoznávání tváře – Detekce nebo (velké)FaceList – Vytvoření nebo (velké)PersonGroup – Vytvoření. Výchozí hodnota je "recognition_01", pokud potřebujete nejnovější model, explicitně zadejte požadovaný model.

userData
  • string

Uživatel zadal data. Délka by neměla překročit 16 kB.

Odpovědi

Name Type Description
200 OK

Úspěšné volání vrátí prázdný text odpovědi.

Other Status Codes

Chybová odpověď.

Zabezpečení

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Příklady

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

Definice

APIError

Informace o chybách vrácené rozhraním API

Error

Text chyby.

MetaDataContract

Kombinace uživatelem definovaných jmen a uživatelem zadaných dat a názvu modelu rozpoznávání pro largePersonGroup/personGroup a largeFaceList/faceList

RecognitionModel

Název modelu rozpoznávání Model rozpoznávání se používá, když se funkce tváře extrahují a přidruží k detekovaným faceId, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění rozpoznávání tváře – Detekce nebo (velké)FaceList – Vytvoření nebo (velké)PersonGroup – Vytvoření. Výchozí hodnota je "recognition_01", pokud potřebujete nejnovější model, explicitně zadejte požadovaný model.

APIError

Informace o chybách vrácené rozhraním API

Name Type Description
error

Text chyby.

Error

Text chyby.

Name Type Description
code
  • string
message
  • string

MetaDataContract

Kombinace uživatelem definovaných jmen a uživatelem zadaných dat a názvu modelu rozpoznávání pro largePersonGroup/personGroup a largeFaceList/faceList

Name Type Default Value Description
name
  • string

Uživatelské definované jméno, maximální délka je 128.

recognitionModel recognition_01

Název modelu rozpoznávání Model rozpoznávání se používá, když se funkce tváře extrahují a přidruží k detekovaným faceId, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění rozpoznávání tváře – Detekce nebo (velké)FaceList – Vytvoření nebo (velké)PersonGroup – Vytvoření. Výchozí hodnota je "recognition_01", pokud potřebujete nejnovější model, explicitně zadejte požadovaný model.

userData
  • string

Uživatel zadal data. Délka by neměla překročit 16 kB.

RecognitionModel

Název modelu rozpoznávání Model rozpoznávání se používá, když se funkce tváře extrahují a přidruží k detekovaným faceId, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění rozpoznávání tváře – Detekce nebo (velké)FaceList – Vytvoření nebo (velké)PersonGroup – Vytvoření. Výchozí hodnota je "recognition_01", pokud potřebujete nejnovější model, explicitně zadejte požadovaný model.

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