Face Recognition Operations - Verify Face To Face

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

HTTP

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.