Person Group Operations - Create Person Group

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2-preview.1

Hozzon létre egy új személycsoportot a megadott personGroupId azonosítóval, névvel, felhasználó által megadott userData és recognitionModel azonosítóval.
A személycsoport egy olyan tároló, amely a feltöltött személyadatokat tartalmazza, beleértve az arcfelismerési funkciókat is.

A létrehozás után használja a "Személycsoport létrehozása" lehetőséget, hogy személyeket vegyen fel a csoportba, majd hívja meg a "Személycsoport betanítása" parancsot, hogy a csoport készen álljon az "Azonosítás személycsoportból" kifejezésre.

A rendszerkép nem lesz tárolva. Csak a kicsomagolt arcfunkció(ka)t és a userData-t tárolja a rendszer a kiszolgálón, amíg meg nem hívja a "Személycsoport törlése" vagy a "Személycsoport törlése" parancsot.

A "recognitionModel" értéket meg kell adni a személycsoporthoz való társításhoz. A "recognitionModel" alapértelmezett értéke "recognition_01", ha a legújabb modellre van szükség, explicit módon adja meg a paraméterben szükséges modellt. A meglévő személycsoporthoz hozzáadott új arcok a gyűjteményhez már társított felismerési modellt fogják használni. A személycsoport meglévő arcfunkciói nem frissíthetők a felismerési modell egy másik verziója által kinyert funkciókra.

Jegyzet

• • Ingyenes szintű előfizetési kvóta: 1000 személycsoport. Mindegyik legfeljebb 1000 főt foglal magában.
  • S0 szintű előfizetési kvóta: 1 000 000 személycsoport. Mindegyik legfeljebb 10 000 személyt foglal magában.
  • a nagyobb léptékű arcfelismerési probléma megoldásához fontolja meg a Large Person Group használatát.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
apiVersion	path	True	string	API-verzió
endpoint	path	True	string uri	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://{resource-name}.cognitiveservices.azure.com).
personGroupId	path	True	string	A tároló azonosítója. Reguláris kifejezési minta: ^[a-z0-9-_]+$

Kérelem törzse

Name	Kötelező	Típus	Description
name	True	string	Felhasználó által megadott név, a maximális hossz 128.
recognitionModel		RecognitionModel	Az arclistához társított "recognitionModel". A támogatott "recognitionModel" értékek közé tartozik a "recognition_01", a "recognition_02, a "recognition_03" és a "recognition_04". Az alapértelmezett érték a "recognition_01". A "recognition_04" használata ajánlott, mivel a maszkot viselő arcok pontossága a "recognition_03" és a "recognition_01" és a "recognition_02" értékhez képest javul.
userData		string	Nem kötelező felhasználó által megadott adatok. A hossz nem haladhatja meg a 16 ezret.

Válaszok

Name	Típus	Description
200 OK		A kérés sikeres volt.
Other Status Codes	FaceErrorResponse	Váratlan hibaválasz. Fejlécek x-ms-error-code: string

Biztonság

Ocp-Apim-Subscription-Key

Az Azure AI Face-előfizetés titkos kulcsa.

Típus: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2 flow

Típus: oauth2
Folyamat: accessCode
Engedélyezési URL: https://api.example.com/oauth2/authorize
Jogkivonat URL-címe: https://api.example.com/oauth2/token

Hatókörök

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

Példák

Create PersonGroup

Mintakérelem

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"
}

Mintaválasz

Állapotkód:

200

Definíciók

Name	Description
FaceError	A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Hibaadatokat tartalmazó válasz.

FaceError

A hibaobjektum. A Face Service által visszaadott hibakódokkal és üzenetekkel kapcsolatos átfogó részletekért tekintse meg a következő hivatkozást: https://aka.ms/face-error-codes-and-messages.

Name	Típus	Description
code	string	A kiszolgáló által definiált hibakódok egyike.
message	string	A hiba ember által olvasható ábrázolása.

FaceErrorResponse

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.