Face Recognition Operations - Identify From Person Group

Dienst:

Azure AI Services

API-Version:

v1.2-preview.1

1:n-Identifikation, um die nächstgelegenen Übereinstimmungen der spezifischen Abfrageperson aus einer Personengruppe zu finden.
Für jedes Gesicht im FaceIds-Array berechnet Face Identify Ähnlichkeiten zwischen dem Abfragegesicht und allen Gesichtern in der Personengruppe (gegeben von personGroupId) und gibt Kandidatenperson(n) für dieses Gesicht zurück, die nach Ähnlichkeitsvertrauen bewertet wurden. Die Personengruppe sollte geschult werden, um sie zur Identifizierung vorzubereiten. Weitere Informationen finden Sie unter "Train Person Group".

Anmerkung

• • Der Algorithmus ermöglicht es mehreren Gesichtern, unabhängig von derselben Anforderung zu identifizieren, aber nicht mehr als 10 Gesichter.
  • Jede Person könnte mehr als ein Gesicht haben, aber nicht mehr als 248 Gesichter.
  • Eine höhere Gesichtsbildqualität bedeutet eine bessere Identifikationsgenauigkeit. Berücksichtigen Sie qualitativ hochwertige Gesichter: Frontal-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen Augen) oder größer.
  • Die Anzahl der zurückgegebenen Kandidaten wird durch maxNumOfCandidatesReturned und confidenceThreshold eingeschränkt. Wenn keine Person identifiziert wird, sind die zurückgegebenen Kandidaten ein leeres Array.
  • Probieren Sie "Ähnliche Suchen" aus, wenn Sie ähnliche Gesichter aus einer Gesichtsliste/großen Gesichtsliste anstelle einer Personengruppe finden müssen.
  • Das "recognitionModel", das mit den FaceIds der Abfragegesichtszeichen verknüpft ist, sollte mit dem von der Zielpersongruppe verwendeten "recognitionModel" übereinstimmen.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
apiVersion	path	True	string	API-Version
endpoint	path	True	string uri	Unterstützte Cognitive Services-Endpunkte (Protokoll und Hostname, z. B. https://{resource-name}.cognitiveservices.azure.com).

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
faceIds	True	string[]	Array von Abfrage faceIds, erstellt durch "Erkennen". Jede der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von FaceIds liegt zwischen [1, 10].
personGroupId	True	string	personGroupId der ZielpersonGruppe, erstellt durch "Personengruppe erstellen". Parameter personGroupId und largePersonGroupId sollten nicht gleichzeitig bereitgestellt werden.
confidenceThreshold		number	Angepasster Schwellenwert für die Identifizierungsvertrauensgrenze im Bereich von [0, 1]. Der erweiterte Benutzer kann diesen Wert optimieren, um den internen Standardschwellenwert zu überschreiben, um die Genauigkeit ihrer Szenariodaten zu verbessern. Beachten Sie, dass dieser Schwellenwert nicht garantiert wird, der an anderen Daten und nach Aktualisierungen des Algorithmus arbeitet.
maxNumOfCandidatesReturned		integer	Der Bereich von maxNumOfCandidatesReturned liegt zwischen 1 und 100. Der Standardwert ist 10.

Antworten

Name	Typ	Beschreibung
200 OK	IdentificationResult[]	Ein erfolgreicher Aufruf gibt die identifizierten Kandidatenperson(n) für jede Abfrageseite zurück.
Other Status Codes	FaceErrorResponse	Unerwartete Fehlerantwort. Header x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

Der geheime Schlüssel für Ihr Azure AI Face-Abonnement.

Typ: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: accessCode
Autorisierungs-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiche

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

Beispiele

Identify from PersonGroup

Beispielanforderung

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
}

Beispiel für eine Antwort

Statuscode:

200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "candidates": [
      {
        "personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
        "confidence": 0.8
      }
    ]
  }
]

Definitionen

Name	Beschreibung
FaceError	Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Eine Antwort, die Fehlerdetails enthält.
IdentificationCandidate	Kandidat für die Identifizierung des Anrufs.
IdentificationResult	Ergebnis identifizieren.

FaceError

Das Fehlerobjekt. Ausführliche Informationen zu Fehlercodes und Nachrichten, die vom Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages.

Name	Typ	Beschreibung
code	string	Eine serverdefinierte Gruppe von Fehlercodes.
message	string	Eine lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

IdentificationCandidate

Kandidat für die Identifizierung des Anrufs.

Name	Typ	Beschreibung
confidence	number	Konfidenzwert des Kandidaten. Je höher das Vertrauen ist, desto ähnlicher. Bereich zwischen [0,1].
personId	string	personId der Kandidatenperson.

IdentificationResult

Ergebnis identifizieren.

Name	Typ	Beschreibung
candidates	IdentificationCandidate[]	Identifizierte Personenkandidaten für dieses Gesicht (bewertet nach Konfidenz). Die Arraygröße sollte nicht größer als die Eingabe "maxNumOfCandidatesReturned" sein. Wenn keine Person identifiziert wird, wird ein leeres Array zurückgegeben.
faceId	string	faceId des Abfragegesichts.