Person Group Operations - Add Person Group Person Face

Ajoutez un visage à une personne dans un groupe de personnes 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 « Supprimer le visage du groupe de personnes », « Supprimer la personne du groupe de personnes » ou « Supprimer le groupe de personnes » soit appelée.

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

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces

POST {endpoint}/face/{apiVersion}/persongroups/{personGroupId}/persons/{personId}/persistedfaces?_overload=addPersonGroupPersonFace&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 PersonGroup Person

POST {endpoint}/face/v1.2-preview.1/persongroups/your_person_group_id/persons/25985303-c537-4467-b41d-bdb45cd95ca1/persistedfaces?_overload=addPersonGroupPersonFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

{
  "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.