Face Recognition Operations - Find Similar From Large Face List

Szolgáltatás:

Azure AI Services

API-verzió:

v1.1-preview.1

Adott lekérdezési arc arcazonosítója, a hasonló arcok kereséséhez egy nagy arclistából. A "largeFaceListId"-et Létrehozás Large Face List hozza létre.
A bemenettől függően a visszaadott hasonló arcok listája faceId-eket vagy perzisztáltFaceId-eket tartalmaz a hasonlóság szerint rangsorolva.

A hasonló keresésnek két munkamódja van: "matchPerson" és "matchFace". A "matchPerson" az alapértelmezett mód, amely a belső azonos személy küszöbértékeinek használatával próbálja megkeresni ugyanannak a személynek az arcát. Hasznos 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ékeit, és egyébként is rangsorolt hasonló arcokat ad vissza, még a hasonlóság is alacsony. Olyan esetekben használható, mint a hírességeknek látszó arcok keresése.

A faceId lekérdezéshez társított "recognitionModel" kifejezésnek meg kell egyeznie a cél nagy arclista á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ési arc faceId azonosítója. A felhasználónak először meg kell hívnia az "Detect" (Észlelés) elemet egy érvényes faceId 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.
largeFaceListId	True	string	A "Létrehozás Large Face List" fájlban létrehozott, felhasználó által megadott egyedi jelölt nagy arclista. A nagyméretű arclista a megőrzöttFaceId-azonosítók készletét tartalmazza, amelyek megmaradnak, és soha nem járnak le.
maxNumOfCandidatesReturned		integer	A legtöbb hasonló arc visszaadott 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 ábrázolt legtöbb hasonló arcot 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 LargeFaceList

Mintakérelem

HTTP

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

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

Mintaválasz

Állapotkód:

200

[
  {
    "confidence": 0.8,
    "faceId": "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 emberi olvasásra alkalmas á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	persistedFaceId a jelölt arcról, amikor a faceListId vagy a largeFaceListId alapján keres. persistedFaceId az arclistában/a nagy arclistában megmarad, és nem jár le.