Large Person Group - Create

Service:

Cognitive Services - Face

API Version:

1.0

Vytvořte novou velkou skupinu osob s parametrem largePersonGroupId zadaným uživatelem, názvem, volitelným parametrem userData a recognitionModel.
Velká skupina osob je kontejnerem nahraných dat osob, včetně funkce rozpoznávání tváře, a až 1 000 000 lidí.
Po vytvoření použijte možnost LargePersonGroup Person – Create k přidání osoby do skupiny a voláním příkazu LargePersonGroup – Train připravte tuto skupinu na rozpoznávání tváře – Identifikace.
Nebude uložena žádná image. Na serveru budou uloženy pouze extrahované funkce tváře a userData osoby, dokud se nezavolá funkce LargePersonGroup Person – Delete nebo LargePersonGroup – Delete .
Pro přidružení k této velké skupině osob by měl být zadán model recognitionModel. Výchozí hodnota pro recognitionModel je "recognition_01". Pokud je potřeba nejnovější model, zadejte explicitně model, který potřebujete v tomto parametru. Nové tváře přidané do existující velké skupiny osob budou používat model rozpoznávání, který je už ke kolekci přidružený. Existující funkce rozpoznávání tváře ve velké skupině osob nelze aktualizovat na funkce extrahované jinou verzí modelu rozpoznávání. Projděte si téma Určení modelu rozpoznávání tváře.

Kvóta velké skupiny osob:

• Kvóta předplatného úrovně Free: 1 000 velkých skupin osob.
• Kvóta předplatného úrovně S0: 1 000 000 velkých skupin osob.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	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	Vyžadováno	Typ	Description
Ocp-Apim-Subscription-Key	True	string

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Uživatelsky definované jméno, maximální délka je 128.
recognitionModel		RecognitionModel	Název modelu rozpoznávání. Model rozpoznávání se používá, když jsou funkce tváře extrahovány a přidruženy ke zjištěným faceIds, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění face - Detect nebo (Large)FaceList - Create nebo (Large)PersonGroup - Create. Výchozí hodnota je "recognition_01". Pokud potřebujete nejnovější model, zadejte explicitně požadovaný model.
userData		string	Data zadaná uživatelem. Délka by neměla překročit 16 kB.

Odpovědi

Name	Typ	Description
200 OK		Úspěšné volání vrátí prázdné tělo odpovědi.
Other Status Codes	APIError	Odpověď na chybu.

Zabezpečení

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Příklady

Create new large person group example

Sample Request

HTTP

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

Status code:

200

Definice

Name	Description
APIError	Informace o chybě vrácené rozhraním API
Error	Text chyby.
MetaDataContract	Kombinace uživatelem definovaného jména a uživatelem zadaného data 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ž jsou funkce tváře extrahovány a přidruženy ke zjištěným faceIds, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění face - Detect nebo (Large)FaceList - Create nebo (Large)PersonGroup - Create. Výchozí hodnota je "recognition_01". Pokud potřebujete nejnovější model, zadejte explicitně požadovaný model.

APIError

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

Name	Typ	Description
error	Error	Text chyby.

Error

Text chyby.

Name	Typ	Description
code	string
message	string

MetaDataContract

Kombinace uživatelem definovaného jména a uživatelem zadaného data a názvu modelu rozpoznávání pro largePersonGroup/personGroup a largeFaceList/faceList.

Name	Typ	Výchozí hodnota	Description
name	string		Uživatelsky definované jméno, maximální délka je 128.
recognitionModel	RecognitionModel	recognition_01	Název modelu rozpoznávání. Model rozpoznávání se používá, když jsou funkce tváře extrahovány a přidruženy ke zjištěným faceIds, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění face - Detect nebo (Large)FaceList - Create nebo (Large)PersonGroup - Create. Výchozí hodnota je "recognition_01". Pokud potřebujete nejnovější model, zadejte explicitně požadovaný model.
userData	string		Data zadaná uživatelem. 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ž jsou funkce tváře extrahovány a přidruženy ke zjištěným faceIds, (Large)FaceList nebo (Large)PersonGroup. Název modelu rozpoznávání je možné zadat při provádění face - Detect nebo (Large)FaceList - Create nebo (Large)PersonGroup - Create. Výchozí hodnota je "recognition_01". Pokud potřebujete nejnovější model, zadejte explicitně požadovaný model.

Name	Typ	Description
recognition_01	string
recognition_02	string
recognition_03	string
recognition_04	string