Face Recognition Operations - Find Similar

Szolgáltatás:

Azure AI Services

API-verzió:

v1.2-preview.1

Adott lekérdezési arc faceId azonosítója, amely hasonló arcokat keres egy faceId tömbből. A faceId tömb az Detect által létrehozott arcokat tartalmazza.
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 faceId tömb által 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	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.
faceIds	True	string[]	A jelöltek faceId-jeinek tömbje. Ezeket az "Detect" hozza létre, és a faceId-azonosítók az észlelési hívás után 24 órával lejárnak. A faceId-azonosítók száma legfeljebb 1000 lehet.
maxNumOfCandidatesReturned		integer	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 among Face IDs

Mintakérelem

HTTP

POST {endpoint}/face/v1.2-preview.1/findsimilars

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "maxNumOfCandidatesReturned": 3,
  "mode": "matchPerson",
  "faceIds": [
    "015839fb-fbd9-4f79-ace9-7675fc2f1dd9",
    "be386ab3-af91-4104-9e6d-4dae4c9fddb7"
  ]
}

Mintaválasz

Állapotkód:

200

[
  {
    "confidence": 0.9,
    "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

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.

FindSimilarResult

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

Name	Típus	Description
confidence	number	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	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	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.