Face Recognition Operations - Identify From Person Group

Usługa:

Azure AI Services

Wersja interfejsu API:

v1.2-preview.1

1-do-wielu identyfikacji w celu znalezienia najbliższych dopasowań określonej osoby zapytania twarz z grupy osób.
Dla każdej twarzy w tablicy faceIds funkcja Face Identify oblicza podobieństwa między twarzą zapytania a wszystkimi twarzami w grupie osób (podanej przez personGroupId) i zwraca osoby kandydata dla tej twarzy sklasyfikowane według zaufania podobieństwa. Grupa osób powinna być wytrenowana, aby była gotowa do identyfikacji. Zobacz więcej w temacie "Train Person Group" (Trenowanie grupy osób).

Nuta

• • Algorytm umożliwia samodzielne zidentyfikowanie więcej niż jednej twarzy w tym samym żądaniu, ale nie więcej niż 10 twarzy.
  • Każda osoba może mieć więcej niż jedną twarz, ale nie więcej niż 248 twarzy.
  • 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.
  • Liczba zwróconych kandydatów jest ograniczona przez wartość maxNumOfCandidatesReturned i confidenceThreshold. Jeśli żadna osoba nie zostanie zidentyfikowana, zwrócony kandydat będzie pustą tablicą.
  • Spróbuj użyć polecenia "Znajdź podobne", jeśli musisz znaleźć podobne twarze z listy twarzy/dużej listy twarzy zamiast grupy osób.
  • Identyfikatory faceId "recognitionModel" skojarzone z twarzami zapytania powinny być takie same jak identyfikatory "recognitionModel" używane przez docelową grupę osób.

POST {endpoint}/face/{apiVersion}/identify

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
faceIds	True	string[]	Tablica twarzy zapytań faceId utworzonych przez "Wykryj". Każda z twarzy jest identyfikowana niezależnie. Prawidłowa liczba identyfikatorów faceId wynosi od [1, 10].
personGroupId	True	string	personGroupId docelowej grupy osób utworzonej przez grupę "Utwórz grupę osób". Parametr personGroupId i largePersonGroupId nie powinny być podane w tym samym czasie.
confidenceThreshold		number	Dostosowany próg ufności identyfikacji w zakresie [0, 1]. Zaawansowany użytkownik może dostosować tę wartość, aby zastąpić domyślny próg wewnętrzny w celu uzyskania lepszej precyzji danych scenariusza. Należy pamiętać, że nie ma gwarancji, że ta wartość progowa działa na innych danych i po aktualizacji algorytmów.
maxNumOfCandidatesReturned		integer	Zakres wartości maxNumOfCandidatesReturned wynosi od 1 do 100. Wartość domyślna to 10.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	IdentificationResult[]	Pomyślne wywołanie zwraca zidentyfikowane osoby kandydata dla każdej twarzy zapytania.
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

Identify from PersonGroup

Przykładowe żądanie

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personGroupId": "your_person_group_id",
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Przykładowa odpowiedź

Kod stanu:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "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.
IdentificationCandidate	Kandydat do identyfikacji połączenia.
IdentificationResult	Zidentyfikuj 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.

IdentificationCandidate

Kandydat do identyfikacji połączenia.

Nazwa	Typ	Opis
confidence	number	Wartość zaufania kandydata. Im większa pewność siebie, tym bardziej podobna. Zakres między [0,1].
personId	string	personId osoby kandydata.

IdentificationResult

Zidentyfikuj wynik.

Nazwa	Typ	Opis
candidates	IdentificationCandidate[]	Zidentyfikowane osoby kandydatów do tej twarzy (sklasyfikowane według zaufania). Rozmiar tablicy nie powinien być większy niż maxNumOfCandidatesReturned. Jeśli żadna osoba nie zostanie zidentyfikowana, zwróci pustą tablicę.
faceId	string	faceId twarzy zapytania.