Face - Verify Face To Face

Service:

Azure AI Services

Version d'API:

1.0-preview

Vérifiez si deux visages appartiennent à une même personne ou si un visage appartient à une personne.
Remarques:

• 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.
• Les faceIds « recognitionModel » associés aux visages de requête doivent être identiques au « recognitionModel » utilisé par le visage cible, le groupe de personnes ou le groupe de personnes volumineux.

POST {Endpoint}/face/v1.0-preview/verify

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
Endpoint	path	True	string	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).

En-tête de la demande

Nom	Obligatoire	Type	Description
Ocp-Apim-Subscription-Key	True	string

Corps de la demande

Nom	Obligatoire	Type	Description
faceId1	True	string (uuid)	FaceId du premier visage, provient de Face - Detect
faceId2	True	string (uuid)	FaceId du deuxième visage, provient de Face - Detect

Réponses

Nom	Type	Description
200 OK	VerifyResult	Un appel réussi retourne le résultat de la vérification.
Other Status Codes	APIError	Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Verify faces example

Exemple de requête

HTTP

POST {Endpoint}/face/v1.0-preview/verify


{
  "faceId1": "c5c24a82-6845-4031-9d5d-978df9175426",
  "faceId2": "815df99c-598f-4926-930a-a734b3fd651c"
}

Exemple de réponse

Code d’état:

200

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

Définitions

Nom	Description
APIError	Informations d’erreur retournées par l’API
Error	Corps de l’erreur.
VerifyFaceToFaceRequest	Demander le corps de la vérification du visage à visage.
VerifyResult	Résultat de l’opération de vérification.

APIError

Object

Informations d’erreur retournées par l’API

Nom	Type	Description
error	Error	Corps de l’erreur.

Error

Object

Corps de l’erreur.

Nom	Type	Description
code	string
message	string

VerifyFaceToFaceRequest

Object

Demander le corps de la vérification du visage à visage.

Nom	Type	Description
faceId1	string (uuid)	FaceId du premier visage, provient de Face - Detect
faceId2	string (uuid)	FaceId du deuxième visage, provient de Face - Detect

VerifyResult

Object

Résultat de l’opération de vérification.

Nom	Type	Description
confidence	number minimum: 0 maximum: 1	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.