Face Recognition Operations - Verify Face To Face

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Vérifiez si deux visages appartiennent à une même personne.

Note

    • Une meilleure qualité d’image de visage signifie une meilleure précision d’identification. Tenez compte des visages de haute qualité : la taille frontale, claire et faciale est de 200 x 200 pixels (100 pixels entre les yeux) ou plus.
    • Pour les scénarios sensibles à la précision, faites votre propre jugement.
    • Le « recognitionModel » associé aux deux visages doit être identique.
POST {endpoint}/face/{apiVersion}/verify

Paramètres URI

Nom Dans Obligatoire Type Description
apiVersion
 path True

string

Version de l’API
endpoint
 path True

string

uri

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).

Corps de la demande

Nom Obligatoire Type Description
faceId1 True

string

Le faceId d’un visage, provient de « Detect ».
faceId2 True

string

Le faceId d’un autre visage, provient de « Detect ».

Réponses

Nom Type Description
200 OK

VerificationResult

Un appel réussi retourne le résultat de la vérification.
Other Status Codes

FaceErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

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

Exemples

Verify Face to Face

Exemple de requête

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

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

Exemple de réponse

Code d’état:
200 
{
  "isIdentical": true,
  "confidence": 0.8
}

Définitions

Nom Description
FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Réponse contenant les détails de l’erreur.
VerificationResult

Vérifiez le résultat.

FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom Type Description
code

string

Un ensemble de codes d’erreur définis par le serveur.
message

string

Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom Type Description
error

FaceError

Objet d’erreur.

VerificationResult

Vérifiez le résultat.

Nom Type Description
confidence

number

Un nombre indique la confiance en similarité de savoir si deux visages appartiennent à la même personne, ou si le visage appartient à la personne. Par défaut, isIdentical a la valeur True si la confiance en similarité est supérieure ou égale à 0,5. Cela est utile pour que les utilisateurs avancés remplacent « isIdentical » et ajustent le résultat sur leurs propres données.
isIdentical

boolean

True si les deux visages appartiennent à la même personne ou que le visage appartient à la personne, sinon false.