Face Recognition Operations - Find Similar From Face List

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2

Adott lekérdezési arc arcazonosítója, a hasonló arcok kereséséhez a face listából. A Face List létrehozása létrehoz egy "faceListId" azonosítót.
A bemenettől függően a visszaadott hasonló arcok listája faceId-eket vagy perzsáltFaceId-eket tartalmaz a hasonlóság szerint rangsorolva.

A hasonló keresésnek két munkamódja van: a "matchPerson" és a "matchFace". A "matchPerson" az alapértelmezett mód, amely belső azonos személy küszöbértékeinek használatával próbálja megtalálni az azonos személy arcait. Hasznos lehet megtalálni egy ismert személy más fényképeit. Vegye figyelembe, hogy a rendszer üres listát ad vissza, ha egyetlen arc sem lépi át a belső küszöbértékeket. A "matchFace" mód figyelmen kívül hagyja az azonos személyű küszöbértékeket, és egyébként is hasonló arcokat ad vissza, még a hasonlóság is alacsony. Olyan esetekben használható, mint a hírességek arcainak keresése.

A faceId lekérdezéshez társított "recognitionModel" értéknek meg kell egyeznie a cél face listához használt "recognitionModel" azonosítóval.

POST {endpoint}/face/{apiVersion}/findsimilars

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
faceId	True	string (uuid)	a lekérdezés arcának faceId azonosítója. A felhasználónak először meg kell hívnia az "Detect" (Észlelés) elemet egy érvényes faceId-azonosító lekéréséhez. Vegye figyelembe, hogy ez a faceId nem marad meg, és az észlelési hívás után 24 órával lejár.
faceListId	True	string	Egy meglévő, felhasználó által megadott egyedi jelölt arclistája, amelyet a "Face List létrehozása" területen hoztak létre. A Face List a megőrzöttFaceId-eket tartalmazza, amelyek megmaradnak, és soha nem járnak le.
maxNumOfCandidatesReturned		integer (int32) minimum: 1 maximum: 1000	A visszaadott leggyakoribb hasonló arcok száma. Az érvényes tartomány :[1, 1000]. Az alapértelmezett érték 20.
mode		FindSimilarMatchMode	Hasonló arckeresési mód. Lehet "matchPerson" vagy "matchFace". Az alapértelmezett érték a "matchPerson".

Válaszok

Name	Típus	Description
200 OK	FindSimilarResult[]	A sikeres hívás a faceId-ben leginkább hasonló arcokat adja vissza, ha a bemeneti paraméter faceIds vagy persistedFaceId, ha a bemeneti paraméter faceListId vagy largeFaceListId.
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

Find Similar from FaceList

Mintakérelem

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceListId": "your_face_list_id"
}

Mintaválasz

Állapotkód:

200

[
  {
    "confidence": 0.8,
    "persistedFaceId": "015839fb-fbd9-4f79-ace9-7675fc2f1dd9"
  }
]

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.
FindSimilarResult	Választörzs hasonló arcművelet megkereséséhez.

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.

FindSimilarResult

Objektum

Választörzs hasonló arcművelet megkereséséhez.

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.
faceId	string (uuid)	faceId a jelölt arc, ha megtalálja a faceIds. A faceId-et az "Detect" hozza létre, és az észlelési hívás után 24 órával lejár.
persistedFaceId	string (uuid)	a faceListId vagy a largeFaceListId alapján történő kereséskor a jelölt arc tartósFaceId azonosítója. A persistedFaceId az arclistában/nagy arclistában megmarad, és nem jár le.