Face Recognition Operations - Verify From Person Directory

Usługa:

Azure AI Services

Wersja interfejsu API:

v1.2-preview.1

Sprawdź, czy twarz należy do osoby w katalogu osób.

Nuta

• • Wyższa jakość obrazu twarzy oznacza lepszą precyzję identyfikacji. Należy wziąć pod uwagę wysokiej jakości twarze: przednie, jasne i rozmiar twarzy to 200x200 pikseli (100 pikseli między oczami) lub większy.
  • W przypadku scenariuszy, które są wrażliwe na dokładność, należy dokonać własnego osądu.
  • Operacja Weryfikuj może być zgodna tylko z twarzami uzyskanymi z tego samego modelu rozpoznawania, który jest skojarzony z twarzą zapytania.

POST {endpoint}/face/{apiVersion}/verify

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
apiVersion	path	True	string	Wersja interfejsu API
endpoint	path	True	string uri	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://{nazwa-zasobu}.cognitiveservices.azure.com).

Treść żądania

Nazwa	Wymagane	Typ	Opis
faceId	True	string	FaceId twarzy pochodzi z "Detect".
personId	True	string	Określ określoną osobę w personDirectory Person.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	VerificationResult	Pomyślne wywołanie zwraca wynik weryfikacji.
Other Status Codes	FaceErrorResponse	Nieoczekiwana odpowiedź na błąd. Nagłówki x-ms-error-code: string

Zabezpieczenia

Ocp-Apim-Subscription-Key

Klucz tajny subskrypcji rozpoznawania twarzy w usłudze Azure AI.

Typ: apiKey
W: header

AADToken

Przepływ OAuth2 usługi Azure Active Directory

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://api.example.com/oauth2/authorize
Adres URL tokenu: https://api.example.com/oauth2/token

Zakresy

Nazwa	Opis
https://cognitiveservices.azure.com/.default

Przykłady

Verify from PersonDirectory

Przykładowe żądanie

HTTP

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

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "personId": "815df99c-598f-4926-930a-a734b3fd651c"
}

Przykładowa odpowiedź

Kod stanu:

200

{
  "isIdentical": true,
  "confidence": 0.8
}

Definicje

Nazwa	Opis
FaceError	Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Odpowiedź zawierająca szczegóły błędu.
VerificationResult	Sprawdź wynik.

FaceError

Obiekt błędu. Aby uzyskać szczegółowe informacje na temat kodów błędów i komunikatów zwracanych przez usługę rozpoznawania twarzy, zapoznaj się z następującym linkiem: https://aka.ms/face-error-codes-and-messages.

Nazwa	Typ	Opis
code	string	Jeden z zdefiniowanych przez serwer zestaw kodów błędów.
message	string	Czytelna dla człowieka reprezentacja błędu.

FaceErrorResponse

Odpowiedź zawierająca szczegóły błędu.

Nazwa	Typ	Opis
error	FaceError	Obiekt błędu.

VerificationResult

Sprawdź wynik.

Nazwa	Typ	Opis
confidence	number	Liczba wskazuje pewność podobieństwa, czy dwie twarze należą do tej samej osoby, czy też twarz należy do osoby. Domyślnie parametr isIdentical ma wartość True, jeśli pewność podobieństwa jest większa lub równa 0,5. Jest to przydatne dla zaawansowanych użytkowników, aby zastąpić wartość "isIdentical" i dostosować wynik na własnych danych.
isIdentical	boolean	Prawda, jeśli dwie twarze należą do tej samej osoby lub twarz należy do osoby, w przeciwnym razie false.