Megosztás a következőn keresztül:


Person Group Operations - Create Large Person Group

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.

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

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 LargePersonGroup

Mintakérelem

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

Mintaválasz

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.