Face Recognition Operations - Verify From Person Group

Service:

Azure AI Services

Version d'API:

v1.2

Vérifiez si un visage appartient à une personne dans un groupe de personnes.

Remarque

• • 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é à la face de requête doit être identique au « recognitionModel » utilisé par le groupe de personnes.

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
faceId	True	string (uuid)	Le faceId du visage, provient de « Detect ».
personGroupId	True	string	Utilisation de personGroupId et personId existants pour le chargement rapide d’une personne spécifiée. personGroupId est créé dans « Créer un groupe de personnes ».
personId	True	string (uuid)	Spécifiez une personne spécifique dans le groupe de personnes.

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 from PersonGroup

Exemple de requête

HTTP

POST {endpoint}/face/v1.2/verify

{
  "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
  "personId": "815df99c-598f-4926-930a-a734b3fd651c",
  "personGroupId": "your_person_group"
}

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

Object

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

Object

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

Nom	Type	Description
error	FaceError	Objet d’erreur.

VerificationResult

Object

Vérifiez le résultat.

Nom	Type	Description
confidence	number (float) 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.