Person Group Operations - Create Large Person Group

Service:

Azure AI Services

API Version:

v1.1-preview.1

Létrehozás egy új large person csoportot a felhasználó által megadott largePersonGroupId azonosítóval, névvel, opcionális userData és recognitionModel azonosítóval.
A Large Person Group egy tároló, amely a feltöltött személyadatokat tartalmazza, beleértve az arcfelismerési funkciókat is. Akár 1 000 000 entitást is tartalmazhat.

A létrehozás után a "Létrehozás Large Person Group Person" paranccsel vegyen fel egy személyt a csoportba, és hívja meg a "Train Large Person Group" (Nagy személycsoport betanítása) parancsot, hogy felkészítse ezt a csoportot az "Azonosítás nagy személyből csoportból" kifejezésre.

A rendszer nem tárol lemezképet. A rendszer csak a kicsomagolt arcfunkció(ka)t és a userData-t tárolja a kiszolgálón, amíg a "Nagy méretű személycsoport törlése" vagy a "Nagy személycsoport törlése" meghívása meg nem történik.

A "recognitionModel" értéket meg kell adni a nagy méretű 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ő Nagy méretű személyek csoporthoz hozzáadott új arcok a gyűjteményhez már társított felismerési modellt fogják használni. A Nagy méretű személyek csoport meglévő arcfunkciói nem frissíthetők a felismerési modell egy másik verziójával kinyert funkciókra.

Megjegyzés

• • Ingyenes szintű előfizetési kvóta: 1000 Nagy személy Csoportok.
  • S0 szintű előfizetési kvóta: 1 000 000 nagy méretű Csoportok.

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

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).
largePersonGroupId	path	True	string	A tároló azonosítója. Regex pattern: ^[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" esetében javult.
userData		string	Nem kötelező felhasználó által megadott adatok. A hossz nem haladhatja meg a 16 000-t.

Válaszok

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

Biztonság

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Az Azure Active Directory OAuth2 flow

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Példák

Create LargePersonGroup

Sample Request

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

Sample Response

Status code:

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 emberi olvasásra alkalmas ábrázolása.

FaceErrorResponse

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.