Face - Find Similar

Szolgáltatás:

Azure AI Services

API-verzió:

1.0

Adott lekérdezési arc faceId azonosítójával a hasonló arcok kereséséhez faceId tömbből, arclistából vagy nagy arclistából. A faceId tömb az Face – Detect with URL vagy Face – Detect with Streamáltal létrehozott arcokat tartalmazza, amelyek a faceIdTimeToLive által a létrehozás után megadott időpontban lejárnak. A faceListId-et a FaceList hozza létre – Olyan létrehozása, amely nem jár le. A "largeFaceListId"-et pedig LargeFaceList – Olyan létrehozása, amely olyan tartósFaceId-eket tartalmaz, amelyek szintén nem járnak le. 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 lekérdezési arc faceId azonosítójával társított "recognitionModel" értéknek meg kell egyeznie a cél faceId tömb, arclista vagy nagyméretű arclista által használt "recognitionModel" azonosítóval.

POST {Endpoint}/face/v1.0/findsimilars

URI-paraméterek

Name	In	Kötelező	Típus	Description
Endpoint	path	True	string	Támogatott Cognitive Services-végpontok (protokoll és állomásnév, például: https://westus.api.cognitive.microsoft.com).

Kérelem fejléce

Name	Kötelező	Típus	Description
Ocp-Apim-Subscription-Key	True	string

Kérelem törzse

Name	Kötelező	Típus	Description
faceId	True	string (uuid)	A lekérdezési arc FaceId azonosítója. A felhasználónak fel kell hívnia a Face - Detect (Észlelés) elemet, hogy érvényes faceId azonosítót kapjon. Vegye figyelembe, hogy ez a faceId nem marad meg, és az észlelési hívás után a faceIdTimeToLive által megadott időpontban lejár.
faceIds		string[] (uuid)	A jelöltek faceId-jeinek tömbje. Mindegyik a Face – Detect szolgáltatással jön létre, és a faceIdTimeToLive által az észlelési hívás után megadott időpontban lejárnak a faceIdTimeToLive azonosítók. A faceId-azonosítók száma legfeljebb 1000 lehet. A faceListId, a largeFaceListId és a faceId paraméter nem adható meg egyszerre.
faceListId		string maxLength: 64 pattern: ^[a-z0-9-_]+$	Egy meglévő, felhasználó által megadott egyedi jelölt arclista, amelyet a Face List – Face List (Arclista létrehozása) listában hoztak létre. Az arclista olyan tartósítottFaceId-azonosítókat tartalmaz, amelyek megmaradnak, és soha nem járnak le. A faceListId, a largeFaceListId és a faceId paraméter nem adható meg egyszerre.
largeFaceListId		string maxLength: 64 pattern: ^[a-z0-9-_]+$	Egy meglévő, felhasználó által megadott egyedi jelölt nagy arclistája, amely a LargeFaceList – Létrehozás listában jön létre. A nagyméretű arcok listája olyan tartósítottFaceId-azonosítókat tartalmaz, amelyek megmaradnak, és soha nem járnak le. A faceListId, a largeFaceListId és a faceId paraméter nem adható meg egyszerre.
maxNumOfCandidatesReturned		integer minimum: 1 maximum: 1000	A visszaadott leggyakoribb hasonló arcok száma. Az érvényes tartomány :[1, 1000].
mode		FindSimilarMatchMode	Hasonló arckeresési mód. Lehet "matchPerson" vagy "matchFace".

Válaszok

Name	Típus	Description
200 OK	SimilarFace[]	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.
Other Status Codes	APIError	Hibaválasz.

Biztonság

Ocp-Apim-Subscription-Key

Típus: apiKey
In: header

Példák

Find similar results example

Mintakérelem

HTTP

POST {Endpoint}/face/v1.0/findsimilars


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

Mintaválasz

Állapotkód:

200

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

Definíciók

Name	Description
APIError	Az API által visszaadott hibainformációk
Error	Hibatörzs.
FindSimilarMatchMode	Hasonló arckeresési mód. Lehet "matchPerson" vagy "matchFace".
FindSimilarRequest	Hasonló művelet megkeresésére szolgáló törzs kérése.
SimilarFace	Választörzs hasonló arcművelet megkereséséhez.

APIError

Objektum

Az API által visszaadott hibainformációk

Name	Típus	Description
error	Error	Hibatörzs.

Error

Objektum

Hibatörzs.

Name	Típus	Description
code	string
message	string

FindSimilarMatchMode

Enumerálás

Hasonló arckeresési mód. Lehet "matchPerson" vagy "matchFace".

Érték	Description
matchFace
matchPerson

FindSimilarRequest

Objektum

Hasonló művelet megkeresésére szolgáló törzs kérése.

Name	Típus	Alapértelmezett érték	Description
faceId	string (uuid)		A lekérdezési arc FaceId azonosítója. A felhasználónak fel kell hívnia a Face - Detect (Észlelés) elemet, hogy érvényes faceId azonosítót kapjon. Vegye figyelembe, hogy ez a faceId nem marad meg, és az észlelési hívás után a faceIdTimeToLive által megadott időpontban lejár.
faceIds	string[] (uuid)		A jelöltek faceId-jeinek tömbje. Mindegyik a Face – Detect szolgáltatással jön létre, és a faceIdTimeToLive által az észlelési hívás után megadott időpontban lejárnak a faceIdTimeToLive azonosítók. A faceId-azonosítók száma legfeljebb 1000 lehet. A faceListId, a largeFaceListId és a faceId paraméter nem adható meg egyszerre.
faceListId	string maxLength: 64 pattern: ^[a-z0-9-_]+$		Egy meglévő, felhasználó által megadott egyedi jelölt arclista, amelyet a Face List – Face List (Arclista létrehozása) listában hoztak létre. Az arclista olyan tartósítottFaceId-azonosítókat tartalmaz, amelyek megmaradnak, és soha nem járnak le. A faceListId, a largeFaceListId és a faceId paraméter nem adható meg egyszerre.
largeFaceListId	string maxLength: 64 pattern: ^[a-z0-9-_]+$		Egy meglévő, felhasználó által megadott egyedi jelölt nagy arclistája, amely a LargeFaceList – Létrehozás listában jön létre. A nagyméretű arcok listája olyan tartósítottFaceId-azonosítókat tartalmaz, amelyek megmaradnak, és soha nem járnak le. A faceListId, a largeFaceListId és a faceId paraméter nem adható meg egyszerre.
maxNumOfCandidatesReturned	integer minimum: 1 maximum: 1000	20	A visszaadott leggyakoribb hasonló arcok száma. Az érvényes tartomány :[1, 1000].
mode	FindSimilarMatchMode	matchPerson	Hasonló arckeresési mód. Lehet "matchPerson" vagy "matchFace".

SimilarFace

Objektum

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

Name	Típus	Description
confidence	number minimum: 0 maximum: 1	A jelölt arc hasonlósága. 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 a Face hozza létre – Észleli és lejár a faceIdTimeToLive által megadott időpontban az észlelési hívás után
persistedFaceId	string (uuid)	A faceListId alapján történő kereséskor a jelölt arc tartós arcazonosítója. A persistedFaceId az arclistában megmarad, és nem jár le. Ahogy az alábbi válasz is mutatja