Person Directory Operations - Add Person Face

Ajoutez un visage à une personne (voir Répertoire de la personne « Créer une personne ») pour l’identification ou la vérification des visages.
Pour gérer une image contenant plusieurs visages, le visage d’entrée peut être spécifié en tant qu’image avec un rectangle targetFace. Elle retourne un persistedFaceId représentant le visage ajouté. Aucune image ne sera stockée. Seules les fonctionnalités de visage extraites sont stockées sur le serveur jusqu’à ce que l’annuaire de personnes « Supprimer le visage de personne » ou « Supprimer la personne » soit appelé.

Notez que persistedFaceId est différent de faceId généré par « Detect ».

• • Une meilleure qualité d’image visage signifie une meilleure précision de reconnaissance. 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.
  • Chaque entrée de personne peut contenir jusqu’à 248 visages.
  • Le format JPEG, PNG, GIF (le premier frame) et BMP sont pris en charge. La taille de fichier image autorisée est comprise entre 1 Ko et 6 Mo.
  • Le rectangle « targetFace » doit contenir un visage. Zéro ou plusieurs visages sont considérés comme une erreur. Si le rectangle « targetFace » fourni n’est pas retourné à partir de « Detect », il n’existe aucune garantie de détecter et d’ajouter le visage avec succès.
  • En dehors de la taille détectable du visage (36x36 - 4096 x 4096 pixels), une grande pose de tête ou de grandes occlusions entraîne des défaillances.
  • La taille minimale détectable du visage est de 36 x 36 pixels dans une image de plus de 1920 x 1080 pixels. Les images avec des dimensions supérieures à 1920 x 1080 pixels nécessitent une taille minimale proportionnellement plus grande.
  • Différentes valeurs « detectionModel » peuvent être fournies. Pour utiliser et comparer différents modèles de détection, reportez-vous à https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-detection-model
• • L’ajout/la suppression de visages vers/à partir d’une même personne sera traité de manière séquentielle. L’ajout/la suppression de visages à/de différentes personnes est traité en parallèle.
  • Il s’agit d’une opération longue. Utilisez l’en-tête de réponse « Operation-Location » pour déterminer quand l’opération AddFace a réussi à se propager pour les futures requêtes à « Identifier ». Pour plus d’informations sur Operation-Locations consultez « Obtenir l’état de l’opération visage ».

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces

POST {endpoint}/face/{apiVersion}/persons/{personId}/recognitionModels/{recognitionModel}/persistedfaces?targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Paramètres URI

Corps de la demande

Media Types: "application/octet-stream"

Réponses

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

Exemples

Add Face to a PersonDirectory Person

POST {endpoint}/face/v1.2-preview.1/persons/85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5/recognitionModels/recognition_01/persistedfaces?targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

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

Définitions

AddFaceResult

Corps de réponse pour l’ajout d’un visage.

DetectionModel

« detectionModel » associé aux faceIds détectés. Les valeurs « detectionModel » prises en charge incluent « detection_01 », « detection_02 » et « detection_03 ». La valeur par défaut est « detection_01 ».

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.

RecognitionModel

Modèle de reconnaissance pour le visage.