Face Recognition Operations - Identify From Large Person Group

Usługa:

Azure AI Services

Wersja interfejsu API:

v1.2-preview.1

Identyfikacja 1-do-wielu w celu znalezienia najbliższych dopasowań określonej osoby kwerendy z grupy dużej osoby.
Dla każdej twarzy w tablicy faceIds funkcja Face Identify oblicza podobieństwa między twarzą zapytania a wszystkimi twarzami w grupie Dużej osoby (na podstawie identyfikatora largePersonGroupId) i zwraca osoby kandydata dla tej twarzy sklasyfikowane według zaufania podobieństwa. Grupa dużych osób powinna być wytrenowana, aby była gotowa do identyfikacji. Zobacz więcej w temacie "Train Large Person Group" (Trenowanie grupy dużych 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/grupy dużej osoby.
  • Identyfikatory faceId "recognitionModel" skojarzone z twarzami zapytania powinny być takie same jak identyfikatory "recognitionModel" używane przez docelową grupę osób lub grupę dużych 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].
largePersonGroupId	True	string	largePersonGroupId docelowej grupy dużych osób utworzonych przez grupę "Utwórz grupę dużych 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 LargePersonGroup

Przykładowe żądanie

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "largePersonGroupId": "your_large_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.