Person Directory Operations - Get Person Face

Service:

Azure AI Services

Version d'API:

v1.2-preview.1

Récupérez les informations sur les visages de la personne. Le visage persistant de la personne est spécifié par son personId. recognitionModel et persistedFaceId.

GET {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces/{persistedFaceId}

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).
persistedFaceId	path	True	string (uuid)	ID de visage du visage.
personId	path	True	string (uuid)	ID de personne de la personne.
recognitionModel	path	True	RecognitionModel	Le « recognitionModel » associé aux visages.

Réponses

Nom	Type	Description
200 OK	PersonDirectoryFace	Un appel réussi retourne les informations du visage persistant cible (persistedFaceId et userData).
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

Get Face from PersonDirectory Person

Exemple de requête

HTTP

GET {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces/43897a75-8d6f-42cf-885e-74832febb055

Exemple de réponse

Code d’état:

200

{
  "persistedFaceId": "43897a75-8d6f-42cf-885e-74832febb055",
  "userData": "your_user_data"
}

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.
PersonDirectoryFace	Ressource Visage pour la personne d’annuaire de personnes.
RecognitionModel	Modèle de reconnaissance pour le visage.

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.

PersonDirectoryFace

Object

Ressource Visage pour la personne d’annuaire de personnes.

Nom	Type	Description
persistedFaceId	string (uuid)	ID de visage du visage.
userData	string maxLength: 1024	Données fournies par l’utilisateur attachées au visage. La limite de longueur est de 1 Ko.

RecognitionModel

Énumération

Modèle de reconnaissance pour le visage.

Valeur	Description
recognition_01	Modèle de reconnaissance par défaut pour « Détecter ». Tous ces faceIds créés avant mars 2019 sont liés à ce modèle de reconnaissance.
recognition_02	Modèle de reconnaissance publié en mars 2019.
recognition_03	Modèle de reconnaissance publié en mai 2020.
recognition_04	Modèle de reconnaissance publié en février 2021. Il est recommandé d’utiliser ce modèle de reconnaissance pour une meilleure précision de reconnaissance.