Person Group Operations - Create Large Person Group

Služba:

Azure AI Services

Verze rozhraní API:

v1.1-preview.1

Create novou velkou skupinu osob s uživatelem zadanými largePersonGroupId, názvem, volitelnou hodnotou userData a recognitionModel.
Velká skupina osob je kontejner, který obsahuje nahraná data osob, včetně funkcí rozpoznávání obličeje. Může obsahovat až 1 000 000 entit.

Po vytvoření přidejte osobu do skupiny "Create Velká skupina osob" a zavolejte "Train Large Person Group" (Vytrénovat velkou skupinu osob), aby se tato skupina připravila na identifikaci z velké skupiny osob.

Nebude uložena žádná image. Na serveru budou uloženy pouze extrahované funkce tváře a uživatelská data osoby, dokud se nezavolá funkce Odstranit velkou skupinu osob nebo Odstranit velkou skupinu osob.

Pro přidružení k této velké skupině osob by měl být zadán parametr recognitionModel. Výchozí hodnota pro recognitionModel je recognition_01. Pokud potřebujete nejnovější model, explicitně zadejte 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 tváře ve velké skupině osob není možné aktualizovat na funkce extrahované jinou verzí modelu rozpoznávání.

Poznámka

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

PUT {endpoint}/face/{apiVersion}/largepersongroups/{largePersonGroupId}

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)
largePersonGroupId	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	Jméno definované uživatelem, 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 v porovnání s "recognition_03" se zvyšuje jeho přesnost u obličejů nasazených v maskách a ve srovnání s výrazy "recognition_01" a "recognition_02".
userData		string	Volitelná uživatelem definovaná data. Délka by neměla překročit 16 kB.

Odpovědi

Name	Typ	Description
200 OK		Žádost byla ú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íč pro vaše předplatné 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 LargePersonGroup

Ukázkový požadavek

HTTP

PUT {endpoint}/face/v1.1-preview.1/largepersongroups/your_large_person_group_id

{
  "name": "your_large_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	Jeden ze serverem definovaných chybových kódů.
message	string	Lidsky čitelná reprezentace chyby.

FaceErrorResponse

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

Name	Typ	Description
error	FaceError	Objekt chyby.