Face Recognition Operations - Identify From Large Person Group

  • Referenz
Dienst:
Azure AI Services
API-Version:
v1.2-preview.1

1:n-Identifikation, um die nächstgelegenen Übereinstimmungen der spezifischen Abfrageperson aus einer Großen Personengruppe zu finden.
Für jedes Gesicht im FaceIds-Array berechnet Face Identify Ähnlichkeiten zwischen dem Abfragegesicht und allen Gesichtern in der Gruppe "Große Person" (angegeben durch largePersonGroupId) und gibt Kandidatenperson(n) für dieses Gesicht zurück, die nach Ähnlichkeitsvertrauen bewertet wurden. Die Gruppe "Große Person" sollte geschult werden, um sie zur Identifizierung vorzubereiten. Weitere Informationen finden Sie unter "Train Large 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/großen Personengruppe finden müssen.
    • Das "recognitionModel", das den Abfragegesichts-Iden zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das von der Zielgruppe "Person Group" oder "Large Person Group" verwendet wird.
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].
largePersonGroupId True

string

largePersonGroupId der Zielgruppe "Große Person", erstellt durch "Große 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 LargePersonGroup

Beispielanforderung

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
}

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.