Face Recognition Operations - Verify From Large Person Group
Überprüfen Sie, ob ein Gesicht zu einer Person in einer großen Personengruppe gehört.
Hinweis
-
- 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.
- Für die Szenarien, die auf Genauigkeit achten, treffen Sie bitte Ihr eigenes Urteil.
- Das "recognitionModel", das dem Abfragegesicht zugeordnet ist, sollte mit dem von der Gruppe "Große Personen" verwendeten "recognitionModel" identisch sein.
POST {endpoint}/face/{apiVersion}/verify
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 |
---|---|---|---|
faceId | True |
string |
Die faceId des Gesichts stammen von "Erkennen". |
largePersonGroupId | True |
string |
Verwenden vorhandener largePersonGroupId und personId zum schnellen Laden einer angegebenen Person. largePersonGroupId wird in "Create große Personengruppe" erstellt. |
personId | True |
string |
Geben Sie eine bestimmte Person in der Großen Personengruppe an. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Ein erfolgreicher Aufruf gibt das Überprüfungsergebnis 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
Verify from LargePersonGroup
Beispielanforderung
POST {endpoint}/face/v1.1-preview.1/verify
{
"faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
"personId": "815df99c-598f-4926-930a-a734b3fd651c",
"largePersonGroupId": "your_large_person_group"
}
Beispiel für eine Antwort
{
"isIdentical": true,
"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. |
Verification |
Überprüfen 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. |
VerificationResult
Überprüfen Sie das Ergebnis.
Name | Typ | Beschreibung |
---|---|---|
confidence |
number |
Eine Zahl gibt die Ähnlichkeitszuversicht an, ob zwei Gesichter zu derselben Person gehören oder ob das Gesicht zur Person gehört. Standardmäßig ist isIdentical auf True festgelegt, wenn die Ähnlichkeitszuverstimmung größer oder gleich 0,5 ist. Dies ist nützlich für fortgeschrittene Benutzer, um "isIdentical" zu überschreiben und das Ergebnis für ihre eigenen Daten zu optimieren. |
isIdentical |
boolean |
True, wenn die beiden Gesichter zur gleichen Person gehören oder das Gesicht zur Person gehört, andernfalls false. |