Face List Operations - Add Face List Face

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2-preview.1

Adjon hozzá egy arcot egy megadott arclistához, legfeljebb 1000 arcot.
Ha több arcot tartalmazó képet szeretne kezelni, a bemeneti arc megadható egy targetFace téglalapot tartalmazó képként. A hozzáadott arcot jelképező tartósFaceId értéket ad vissza. A rendszerkép nem lesz tárolva. A rendszer csak a kinyert arcfunkció(ka)t tárolja a kiszolgálón, amíg a "Face List Face törlése" vagy a "Arclista törlése" meghívása meg nem történik.

Vegye figyelembe, hogy a persistedFaceId nem azonos az "Detect" által létrehozott faceId azonosítóval.

• • A jobb arcképminőség jobb felismerési pontosságot jelent. Vegye figyelembe a kiváló minőségű arcokat: előtérbeli, világos és arcmérete 200x200 képpont (100 képpont a szem között) vagy nagyobb.
  • Minden személy bejegyzése legfeljebb 248 arcot tartalmazhat.
  • A JPEG, a PNG, a GIF (az első képkocka) és a BMP formátum támogatott. Az engedélyezett képfájl mérete 1KB és 6 MB között van.
  • A "targetFace" téglalapnak egy arcot kell tartalmaznia. A nulla vagy több arcot hibaként fogjuk kezelni. Ha a megadott "targetFace" téglalapot nem adja vissza az "Detect" függvény, nincs garancia az arc sikeres észlelésére és hozzáadására.
  • A nem észlelhető arcméret (36x36 - 4096x4096 képpont), a nagy fej-póz vagy a nagy elzáródások meghibásodást okoznak.
  • A minimálisan észlelhető arcméret 36x36 képpont egy 1920x1080 képpontnál nem nagyobb képben. Az 1920x1080 képpontnál nagyobb méretű képeknek arányosan nagyobb minimális arcméretre lesz szükségük.
  • Különböző "detectionModel" értékeket lehet megadni. A különböző észlelési modellek használatához és összehasonlításához tekintse meg https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces

Opcionális paraméterekkel:

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

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).
faceListId	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-_]+$
detectionModel	query		DetectionModel	Az észlelt faceId-ekhez társított "detectionModel". A támogatott "detectionModel" értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01".
targetFace	query		integer[]	Arc téglalap a személyhez hozzáadni kívánt céllap megadásához a "targetFace=left,top,width,height" formátumban.
userData	query		string	A felhasználó által megadott adatok az archoz vannak csatolva. A méretkorlát 1K.

Kérelem törzse

Media Types: "application/octet-stream"

Name	Típus	Description
imageContent	string	Az elemezni kívánt kép

Válaszok

Name	Típus	Description
200 OK	AddFaceResult	A sikeres hívás egy új, megőrzöttFaceId azonosítót ad vissza.
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

Add Face to FaceList

Mintakérelem

HTTP

POST {endpoint}/face/v1.2-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

Mintaválasz

Állapotkód:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055"
}

Definíciók

Name	Description
AddFaceResult	Válasz törzs az arc hozzáadásához.
DetectionModel	Az észlelt faceId-ekhez társított "detectionModel". A támogatott "detectionModel" értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01".
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.

AddFaceResult

Válasz törzs az arc hozzáadásához.

Name	Típus	Description
persistedFaceId	string	A hozzáadott arc tartós arcazonosítója, amely megmarad, és nem jár le. Eltér az "Detect" (Észlelés) szolgáltatásban létrehozott faceId azonosítótól, és az észlelési hívás után 24 órán belül lejár.

DetectionModel

Az észlelt faceId-ekhez társított "detectionModel". A támogatott "detectionModel" értékek közé tartozik a "detection_01", a "detection_02" és a "detection_03". Az alapértelmezett érték a "detection_01".

Name	Típus	Description
detection_01	string	Az alapértelmezett észlelési modell. A közel frontális arcfelismeréshez ajánlott. Kivételesen nagy szögű (fej-póz) arcokkal, elzárt arcokkal vagy rossz kép tájolással rendelkező forgatókönyvek esetén előfordulhat, hogy az ilyen esetekben az arcok nem észlelhetők.
detection_02	string	Az észlelési modell 2019 májusában jelent meg, nagyobb pontossággal, különösen a kis, oldalsó és homályos arcokon.
detection_03	string	Az észlelési modell 2021 februárjában jelent meg, nagyobb pontossággal, különösen a kis arcokon.

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.