Face List Operations - Create Large Face List

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2-preview.1

Hozzon létre egy üres nagyméretű arclistát a felhasználó által megadott largeFaceListId azonosítóval, névvel, opcionális userData-val és recognitionModellel.
A Nagyméretű arcok listája egy arclista, amely legfeljebb 1 000 000 arcot tartalmaz, és amelyet a "Hasonló keresése nagy arclistából" kifejezés használ.

A létrehozás után a felhasználónak a Nagy arclista hozzáadása arc hozzáadása használatával kell importálnia az arcokat, és be kell tanítania a nagyméretű arclistát, hogy készen álljon a "Hasonlóak keresése" kifejezésre. A rendszerkép nem lesz tárolva. A rendszer csak a kinyert arcfunkció(ka)t tárolja a kiszolgálón, amíg meg nem hívja a Nagy arclista törlése parancsot.

A "Hasonló keresése" olyan helyzetekben használatos, mint a hírességhez hasonló arcok keresése, hasonló arcszűrés vagy világos arcfelismerés. Ha azonban a tényleges felhasználás személyazonosításra van, használja a Személycsoport/Nagy személy csoportot és az "Azonosítás" lehetőséget.

Jegyzet

• • Ingyenes szintű előfizetési kvóta: 64 nagyméretű arclista.
  • S0 szintű előfizetési kvóta: 1 000 000 nagy arclista.

PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

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).
largeFaceListId	path	True	string	Az érvényes karakter kisbetűs vagy számjegyű, "-" vagy "_", maximális hossza 64. 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 LargeFaceList

Mintakérelem

HTTP

PUT {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id

{
  "name": "your_large_face_list_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.