Face Recognition Operations - Identify From Person Group
1:0-Identifizierung, um die nächstgelegenen Übereinstimmungen des jeweiligen Abfragepersonengesichts 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 (angegeben durch personGroupId) und gibt Kandidatenperson(en) für dieses Gesicht zurück, das nach Ähnlichkeitsvertrauen bewertet wird. Die Personengruppe sollte so trainiert werden, dass sie für die Identifizierung bereit ist. Weitere Informationen finden Sie unter "Train Person Group".
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.
- Versuchen Sie "Ähnlich suchen", wenn Sie ähnliche Gesichter aus einer Gesichtsliste/einer großen Gesichtsliste anstelle einer Personengruppe finden müssen.
- Das "recognitionModel", das den FaceIds der Abfragegesichter zugeordnet ist, sollte mit dem von der Zielpersonengruppe verwendeten "recognitionModel" identisch sein.
POST {endpoint}/face/{apiVersion}/identify
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
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]. |
personGroupId | True |
string |
personGroupId der Zielpersonsgruppe, erstellt von "Create Personengruppe". Die Parameter personGroupId und largePersonGroupId sollten nicht gleichzeitig bereitgestellt werden. |
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 |
Ein erfolgreicher Aufruf gibt die identifizierten Kandidatenpersonen für jedes Abfragegesicht zurück. |
|
Other Status Codes |
Eine 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-Flow
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
POST {endpoint}/face/v1.1-preview.1/identify
{
"faceIds": [
"c5c24a82-6845-4031-9d5d-978df9175426"
],
"personGroupId": "your_person_group_id",
"maxNumOfCandidatesReturned": 9,
"confidenceThreshold": 0.7
}
Beispiel für eine Antwort
[
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"candidates": [
{
"personId": "85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5",
"confidence": 0.8
}
]
}
]
Definitionen
Name | Beschreibung |
---|---|
Face |
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. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
Identification |
Kandidat für den Anruf identifizieren. |
Identification |
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 |
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 |
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. |