Face Recognition Operations - Verify Face To Face
Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören.
Anmerkung
-
- 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.
- Für die Szenarien, die für die Genauigkeit sensibel sind, legen Sie bitte Ihr eigenes Urteil fest.
- Das "recognitionModel", das beiden Gesichtern zugeordnet ist, sollte 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 |
---|---|---|---|
faceId1 | True |
string |
Die FaceId eines Gesichtes stammt von "Erkennen". |
faceId2 | True |
string |
Die FaceId eines anderen Gesichts stammt von "Erkennen". |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Ein erfolgreicher Aufruf gibt das Überprüfungsergebnis zurück. |
|
Other Status Codes |
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
Verify Face to Face
Beispielanforderung
POST {endpoint}/face/v1.2-preview.1/verify
{
"faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
"faceId2": "3aa87e30-b380-48eb-ad9e-1aa54fc52bd3"
}
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 Face Service zurückgegeben werden, finden Sie unter folgendem Link: https://aka.ms/face-error-codes-and-messages. |
Face |
Eine Antwort, die Fehlerdetails enthält. |
Verification |
Ergebnis überprüfen. |
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 |
Das Fehlerobjekt. |
VerificationResult
Ergebnis überprüfen.
Name | Typ | Beschreibung |
---|---|---|
confidence |
number |
Eine Zahl gibt die Ähnlichkeitswahrscheinlichkeit an, ob zwei Gesichter zur gleichen Person gehören oder ob das Gesicht zur Person gehört. IsIdentical ist standardmäßig auf "True" festgelegt, wenn die Ähnlichkeitswahrscheinlichkeit größer oder gleich 0,5 ist. Dies ist nützlich für erweiterte Benutzer, um "isIdentical" außer Kraft zu setzen und das Ergebnis in ihren eigenen Daten zu optimieren. |
isIdentical |
boolean |
True, wenn die beiden Gesichter zur gleichen Person gehören oder das Gesicht zur Person gehört, andernfalls falsch. |