Face Recognition Operations - Identify From Person Group

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2

1-a-többhöz azonosítás az adott lekérdezési személy arcának legközelebbi egyezéseinek megkereséséhez egy személycsoportból.
A faceIds tömb minden egyes arcához a Face Identify kiszámítja a hasonlóságokat a lekérdezési arc és a személycsoport összes arca között (a personGroupId alapján), és a hasonlóság megbízhatósága alapján rangsorolt személy(ek)et ad vissza az adott archoz. A személycsoportot be kell tanítani, hogy készen álljon az azonosításra. További információt a "Személy betanítása csoport" című témakörben talál.

Jegyzet

• • Az algoritmus lehetővé teszi több arc egymástól függetlenül történő azonosítását ugyanabban a kérelemben, de legfeljebb 10 arcot.
  • Minden személynek több arca lehet, de legfeljebb 248 arc.
  • A jobb arcképminőség jobb azonosítá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.
  • A visszaadott jelöltek számát a maxNumOfCandidatesReturned és a confidenceThreshold korlátozza. Ha senki sem azonosítható, a visszaadott jelöltek üres tömbök lesznek.
  • Próbálja ki a "Hasonló keresése" elemet, ha személycsoport helyett arclistából/nagy arclistából kell hasonló arcokat találnia.
  • A lekérdezési arcokhoz társított "recognitionModel" faceId-eknek meg kell egyezniük a célszemélycsoport által használt "recognitionModel" azonosítóval.

POST {endpoint}/face/{apiVersion}/identify

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

Kérelem törzse

Name	Kötelező	Típus	Description
faceIds	True	string[] (uuid)	A "Detect" által létrehozott faceIds lekérdezési arcok tömbje. A rendszer minden arcot egymástól függetlenül azonosít. Az arcazonosítók érvényes száma [1, 10] között van.
personGroupId	True	string	A célszemélycsoport personGroupId azonosítója, amelyet a "Személy létrehozása csoport" hozott létre. A personGroupId és a largePersonGroupId paraméter nem adható meg egyszerre.
confidenceThreshold		number (float) minimum: 0 maximum: 1	Személyre szabott azonosítási megbízhatósági küszöbérték a(z) [0, 1] tartományban. A haladó felhasználók módosíthatják ezt az értéket úgy, hogy felülbírálják az alapértelmezett belső küszöbértéket a forgatókönyv adatainak jobb pontossága érdekében. Vegye figyelembe, hogy nincs garancia arra, hogy ez a küszöbérték más adatokon és algoritmusfrissítések után is működik.
maxNumOfCandidatesReturned		integer (int32) minimum: 1 maximum: 100	A maxNumOfCandidatesReturned tartománya 1 és 100 között van. Az alapértelmezett érték 10.

Válaszok

Name	Típus	Description
200 OK	IdentificationResult[]	A sikeres hívás minden lekérdezési archoz visszaadja az azonosított személy(ek)et.
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

Identify from PersonGroup

Mintakérelem

HTTP

POST {endpoint}/face/v1.2/identify

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Mintaválasz

Állapotkód:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "confidence": 0.8
      }
    ]
  }
]

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.
IdentificationCandidate	A hívás azonosítására jelölt.
IdentificationResult	Az eredmény azonosítása.

FaceError

Objektum

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

Objektum

Hibaadatokat tartalmazó válasz.

Name	Típus	Description
error	FaceError	A hibaobjektum.

IdentificationCandidate

Objektum

A hívás azonosítására jelölt.

Name	Típus	Description
confidence	number (float) minimum: 0 maximum: 1	A jelölt megbízhatósági értéke. Minél nagyobb a bizalom, annál hasonlóbb. [0,1] közötti tartomány.
personId	string (uuid)	a jelölt személyazonosítója.

IdentificationResult

Objektum

Az eredmény azonosítása.

Name	Típus	Description
candidates	IdentificationCandidate[]	Azonosított személy jelölt erre az arcra (megbízhatóság alapján rangsorolva). A tömb mérete nem lehet nagyobb a bemeneti maxNumOfCandidatesReturned értéknél. Ha senki sem azonosítható, üres tömböt ad vissza.
faceId	string (uuid)	a lekérdezés arcának faceId azonosítója.