Person Group Operations - Add Person Group Person Face

Service:

Azure AI Services

API Version:

v1.1-preview.1

Arcfelismerés vagy -ellenőrzés céljából vegyen fel egy arcot egy személycsoportba.
A több arcot tartalmazó kép kezeléséhez a bemeneti arc megadható egy targetFace téglalapot tartalmazó képként. Egy megőrzöttFaceId azonosítót ad vissza, amely a hozzáadott arcot jelöli. A rendszer nem tárol lemezképet. A rendszer csak a kinyert arcfunkció(ka)t tárolja a kiszolgálón, amíg a "Személycsoport-személy arcának törlése", a "Személycsoport törlése" vagy a "Személycsoport törlése" kifejezés meg nem hívódik.

Vegye figyelembe, hogy a persistedFaceId különbözik az "Detect" által létrehozott faceId-től.

• • 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 szemek 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 1 KB és 6 MB között van.
  • A "targetFace" téglalapnak egy arcot kell tartalmaznia. A nulla vagy több arcot a rendszer hibának tekinti. Ha a megadott "targetFace" téglalapot nem adja vissza a rendszer az "Detect" kifejezésből, nincs garancia az arc sikeres észlelésére és hozzáadására.
  • A felismerhető arcméret (36x36 – 4096x4096 képpont), a nagy fej-póz vagy a nagy méretű elzáródások hibákat okoznak.
  • A minimálisan észlelhető arcméret 36x36 képpont egy 1920x1080 képpontnál nem nagyobb képben. A 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ékek is megadhatóak. A különböző észlelési modellek használatához és összehasonlításához tekintse meg a következőt: https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces

With optional parameters:

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces?_overload=addPersonGroupPersonFace&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).
personGroupId	path	True	string	A tároló azonosítója. Regex pattern: ^[a-z0-9-_]+$
personId	path	True	string uuid	A személy azonosítója.
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 következő formátumban: "targetFace=left,top,width,height".
userData	query		string	Felhasználó által megadott adatok az archoz 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. 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

Add Face to PersonGroup Person

Sample Request

HTTP

POST {endpoint}/face/v1.1-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?_overload=addPersonGroupPersonFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

Sample Response

Status code:

200

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

Definíciók

Name	Description
AddFaceResult	Választö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álasztörzs az arc hozzáadásához.

Name	Típus	Description
persistedFaceId	string	A hozzáadott arc megőrzött arcazonosítója, amely megmarad, és nem jár le. A faceId-től eltérő, amely az "Detect" (Észlelés) szakaszban jön létre, é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ő helyzetekben előfordulhat, hogy az ilyen esetekben az arcok nem észlelhetők.
detection_02	string	A 2019 májusában kiadott észlelési modell nagyobb pontosságot eredményez, különösen a kis, oldalsó és homályos arcokon.
detection_03	string	A 2021 februárjában kiadott észlelési modell 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 emberi olvasásra alkalmas ábrázolása.

FaceErrorResponse

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.