Person Group Operations - Create Person Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Vytvořte novou skupinu osob se zadaným personGroupId, jménem, uživatelem zadaným userData a recognitionModel.
Skupina osob je kontejner obsahující nahraná data osob, včetně funkcí rozpoznávání tváře.

Po vytvoření použijte možnost Vytvořit osobu skupiny osob k přidání osob do skupiny a voláním "Train Person Group" (Skupina osob trénovat) připravte tuto skupinu na možnost Identifikovat ze skupiny osob.

Neuloží se žádná image. Na serveru budou uloženy pouze extrahované funkce tváře a userData, dokud nebude volána možnost Odstranit osobu skupiny osob nebo Odstranit skupinu osob.

Parametr recognitionModel by měl být určen pro přidružení k této skupině osob. Výchozí hodnota pro "recognitionModel" je "recognition_01", pokud je potřeba nejnovější model, explicitně zadejte požadovaný model v tomto parametru. Nové tváře přidané do existující skupiny osob budou používat model rozpoznávání, který je už přidružený k kolekci. Existující funkce tváře ve skupině osob se nedají aktualizovat na funkce extrahované jinou verzí modelu rozpoznávání.

Poznámka

• • Kvóta předplatného úrovně Free: 1 000 skupin osob. Každý má až 1 000 osob.
  • Kvóta předplatného úrovně S0: 1 000 000 skupin osob. Každý má až 10 000 osob.
  • pokud chcete vyřešit problém s větší identifikací tváře, zvažte použití velké skupiny osob.

PUT {endpoint}/face/{apiVersion}/persongroups/{personGroupId}

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
personGroupId	path	True	string	ID kontejneru. Vzor regulárního výrazu: ^[a-z0-9-_]+$

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Uživatelem definované jméno, maximální délka je 128.
recognitionModel		RecognitionModel	Model rozpoznávání přidružený k tomuto seznamu tváří. Mezi podporované hodnoty recognitionModel patří recognition_01, recognition_02, recognition_03 a recognition_04. Výchozí hodnota je recognition_01. "recognition_04" se doporučuje, protože jeho přesnost je vylepšená u tváří s maskami na sobě ve srovnání s "recognition_03" a její celková přesnost se v porovnání s "recognition_01" a "recognition_02".
userData		string	Volitelná uživatelsky definovaná data Délka by neměla překročit 16 tisíc.

Odpovědi

Name	Typ	Description
200 OK		Požadavek byl úspěšný.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

Name	Description
https://cognitiveservices.azure.com/.default

Příklady

Create PersonGroup

Ukázkový požadavek

HTTP

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

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

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.