Face Recognition Operations - Identify From Person Directory

Service:

Azure AI Services

API Version:

v1.1-preview.1

1-zu-viele-Identifizierung, um die nächstgelegenen Übereinstimmungen der jeweiligen Abfrageperson aus einem Person Directory personIds-Array zu finden.
Für jedes Gesicht im faceIds-Array berechnet Face Identify Ähnlichkeiten zwischen dem Abfragegesicht und allen Gesichtern in der Person Directory Persons (angegeben durch personIds) und gibt Kandidatenpersonen für dieses Gesicht zurück, die nach Ähnlichkeitsvertrauen eingestuft werden. Das Übergeben von personIds mit einem Array mit einem Element "*" kann den Vorgang über das gesamte Personenverzeichnis ausführen.

Hinweis

• • Mit dem Algorithmus können mehrere Gesichter unabhängig bei derselben Anforderung identifiziert werden, aber nicht mehr als 10 Gesichter.
  • Jede Person könnte mehr als ein Gesicht haben, aber nicht mehr als 248 Gesichter.
  • Höhere Gesichtsbildqualität bedeutet eine höhere Identifikationsgenauigkeit. Bitte berücksichtigen Sie hochwertige Gesichter: Die Front-, Klar- und Gesichtsgröße beträgt 200 x 200 Pixel (100 Pixel zwischen den 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.
  • Der Vorgang Identifizieren kann nur mit Gesichtern übereinstimmen, die mit demselben Erkennungsmodell abgerufen wurden, das den Abfrageflächen zugeordnet ist.

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 Abfragegesichts-FaceIds, erstellt von "Detect". Jedes der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von faceIds liegt zwischen [1, 10].
personIds	True	string[]	Array von PersonIds, die im Personenverzeichnis "Create Person" erstellt wurden. Die gültige Anzahl von personIds liegt zwischen [1,30].
confidenceThreshold		number	Benutzerdefinierter Schwellenwert für die Identifikationssicherheit im Bereich von [0, 1]. Fortgeschrittene Benutzer können diesen Wert optimieren, um den internen Standardschwellenwert für eine bessere Genauigkeit ihrer Szenariodaten zu überschreiben. Beachten Sie, dass dieser Schwellenwert für andere Daten und nach Algorithmusupdates nicht garantiert wird.
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 Kandidatenpersonen für jedes Abfragegesicht zurück.
Other Status Codes	FaceErrorResponse	Eine unerwartete Fehlerantwort. Headers x-ms-error-code: string

Sicherheit

Ocp-Apim-Subscription-Key

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

Type: apiKey
In: header

AADToken

Der Azure Active Directory OAuth2-Flow

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

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

Beispiele

Identify from PersonDirectory

Sample Request

HTTP

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

{
  "faceIds": [
    "c5c24a82-6845-4031-9d5d-978df9175426"
  ],
  "personIds": [
    "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
  ],
  "maxNumOfCandidatesReturned": 9,
  "confidenceThreshold": 0.7
}

Sample Response

Status code:

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 Gesichtserkennungsdienst 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 den Anruf identifizieren.
IdentificationResult	Identifizieren sie das Ergebnis.

FaceError

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

Name	Typ	Beschreibung
code	string	Einer der vom Server definierten Fehlercodes.
message	string	Eine für Menschen lesbare Darstellung des Fehlers.

FaceErrorResponse

Eine Antwort, die Fehlerdetails enthält.

Name	Typ	Beschreibung
error	FaceError	Das Fehlerobjekt.

IdentificationCandidate

Kandidat für den Anruf identifizieren.

Name	Typ	Beschreibung
confidence	number	Vertrauenswert des Kandidaten. Je höher die Zuverlässigkeit, desto ähnlicher. Bereich zwischen [0,1].
personId	string	personId der Kandidatenperson.

IdentificationResult

Identifizieren sie das Ergebnis.

Name	Typ	Beschreibung
candidates	IdentificationCandidate[]	Identifizierte Personenkandidaten für dieses Gesicht (geordnet nach Vertrauen). 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.