Face Recognition Operations - Find Similar

Služba:

Azure AI Services

Verze rozhraní API:

v1.2-preview.1

Pokud chcete prohledat podobné tváře z pole faceId daného dotazu, vyhledejte podobné tváře. Pole faceId obsahuje tváře vytvořené funkcí Detect.
V závislosti na vstupu vrácený seznam podobných tváří obsahuje faceIds nebo trvaléFaceIds seřazené podle podobnosti.

Funkce Najít podobná má dva pracovní režimy: "matchPerson" a "matchFace". "matchPerson" je výchozí režim, který se snaží najít tváře stejné osoby co možná pomocí interních prahových hodnot stejné osoby. Je užitečné najít další fotky známé osoby. Všimněte si, že prázdný seznam bude vrácen, pokud žádné tváře nepřejdou vnitřní prahové hodnoty. Režim matchFace ignoruje prahové hodnoty stejné osoby a přesto vrací seřazené podobné tváře, i když je podobnost nízká. Dá se použít v případech, jako je vyhledávání tváří s celebritou.

Objekt recognitionModel přidružený k id tváře dotazu by měl být stejný jako model recognitionModel používaný cílovým polem faceId.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
apiVersion	path	True	string	Verze rozhraní API
endpoint	path	True	string uri	Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).

Text požadavku

Name	Vyžadováno	Typ	Description
faceId	True	string	faceId tváře dotazu. Aby uživatel získal platné faceId, musí nejprve volat "Detect". Všimněte si, že toto faceId není trvalé a vyprší 24 hodin po volání detekce.
faceIds	True	string[]	Pole kandidátských faceId. Všechny z nich se vytvoří pomocí funkce Detect (Zjistit) a id faceId vyprší 24 hodin po volání detekce. Počet faceId je omezený na 1 000.
maxNumOfCandidatesReturned		integer	Počet vrácené horních podobných tváří. Platný rozsah je [1, 1000]. Výchozí hodnota je 20.
mode		FindSimilarMatchMode	Podobný režim vyhledávání tváří Může to být matchPerson nebo matchFace. Výchozí hodnota je matchPerson.

Odpovědi

Name	Typ	Description
200 OK	FindSimilarResult[]	Úspěšné volání vrátí pole nejvíce podobných tváří reprezentovaných v faceId, pokud je vstupní parametr faceIds nebo trvalýFaceId, pokud je vstupní parametr faceListId nebo largeFaceListId.
Other Status Codes	FaceErrorResponse	Neočekávaná chybová odpověď Hlavičky x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

Name	Description
https://cognitiveservices.azure.com/.default

Příklady

Find Similar among Face IDs

Ukázkový požadavek

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"
  ]
}

Ukázková odpověď

Stavový kód:

200

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

Definice

Name	Description
FaceError	Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpověď obsahující podrobnosti o chybě.
FindSimilarResult	Tělo odpovědi pro vyhledání podobné operace tváře

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Description
code	string	Jedna ze serverově definovaných kódů chyb.
message	string	Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name	Typ	Description
error	FaceError	Objekt chyby.

FindSimilarResult

Tělo odpovědi pro vyhledání podobné operace tváře

Name	Typ	Description
confidence	number	Hodnota spolehlivosti kandidáta Čím větší spolehlivost, tím podobnou. Rozsah mezi [0,1].
faceId	string	faceId kandidátské tváře při hledání podle faceId. FaceId vytvoří funkce Detect a vyprší 24 hodin po volání detekce.
persistedFaceId	string	trvaláFaceId kandidátské tváře při hledání podle faceListId nebo largeFaceListId. persistedFaceId v seznamu tváří nebo velký seznam tváří je trvalý a nevyprší platnost.