Face Recognition Operations - Verify Face To Face

Service:

Azure AI Services

API-versie:

v1.2-preview.1

Controleer of twee gezichten tot dezelfde persoon behoren.

Notitie

• • Een hogere afbeeldingskwaliteit van het gezicht betekent een betere identificatieprecisie. Overweeg gezichten van hoge kwaliteit: frontaal, helder en gezichtsgrootte is 200x200 pixels (100 pixels tussen ogen) of groter.
  • Voor de scenario's die gevoelig zijn voor nauwkeurigheid, moet u uw eigen oordeel geven.
  • Het 'recognitionModel' dat aan beide gezichten is gekoppeld, moet hetzelfde zijn.

POST {endpoint}/face/{apiVersion}/verify

URI-parameters

Name	In	Vereist	Type	Description
apiVersion	path	True	string	API-versie
endpoint	path	True	string uri	Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com).

Aanvraagbody

Name	Vereist	Type	Description
faceId1	True	string	De faceId van één gezicht komt van 'Detecteren'.
faceId2	True	string	De faceId van een ander gezicht komt van 'Detecteren'.

Antwoorden

Name	Type	Description
200 OK	VerificationResult	Een geslaagde aanroep retourneert het verificatieresultaat.
Other Status Codes	FaceErrorResponse	Een onverwachte foutreactie. Kopteksten x-ms-error-code: string

Beveiliging

Ocp-Apim-Subscription-Key

De geheime sleutel voor uw Azure AI Face-abonnement.

Type: apiKey
In: header

AADToken

De Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: accessCode
Autorisatie-URL: https://api.example.com/oauth2/authorize
Token-URL: https://api.example.com/oauth2/token

Bereiken

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

Voorbeelden

Verify Face to Face

Voorbeeldaanvraag

HTTP

POST {endpoint}/face/v1.2-preview.1/verify

{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "3aa87e30-b380-48eb-ad9e-1aa54fc52bd3"
}

Voorbeeldrespons

Statuscode:

200

{
  "isIdentical": true,
  "confidence": 0.8
}

Definities

Name	Description
FaceError	Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse	Een antwoord met foutdetails.
VerificationResult	Controleer het resultaat.

FaceError

Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.

Name	Type	Description
code	string	Een van een door de server gedefinieerde set foutcodes.
message	string	Een leesbare weergave van de fout.

FaceErrorResponse

Een antwoord met foutdetails.

Name	Type	Description
error	FaceError	Het foutobject.

VerificationResult

Controleer het resultaat.

Name	Type	Description
confidence	number	Een getal geeft de gelijkenis aan of twee gezichten tot dezelfde persoon behoren of dat het gezicht tot de persoon behoort. IsIdentical is standaard ingesteld op Waar als het betrouwbaarheidsvertrouwen groter is dan of gelijk is aan 0,5. Dit is handig voor geavanceerde gebruikers om 'isIdentical' te overschrijven en het resultaat op hun eigen gegevens af te stemmen.
isIdentical	boolean	Waar als de twee gezichten tot dezelfde persoon behoren of het gezicht tot de persoon behoort, anders onwaar.