Face List Operations - Add Face List Face

Service:

Azure AI Services

Version d'API:

v1.1-preview.1

Ajoutez un visage à une liste de visages spécifiée, jusqu’à 1 000 visages.
Pour traiter une image contenant plusieurs visages, le visage d’entrée peut être spécifié en tant qu’image avec un rectangle targetFace. Il retourne unFaceId persistant représentant le visage ajouté. Aucune image n’est stockée. Seules les fonctionnalités de visage extraites sont stockées sur le serveur jusqu’à ce que l’option « Supprimer la liste visage » ou « Supprimer la liste de visages » soit appelée.

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

• • Une meilleure qualité d’image du visage signifie une meilleure précision de reconnaissance. Tenez compte des visages de haute qualité : frontal, clair, et la taille du visage est de 200 x 200 pixels (100 pixels entre les yeux) ou plus.
  • Chaque entrée de personne peut contenir jusqu’à 248 visages.
  • Les formats JPEG, PNG, GIF (première image) et BMP sont pris en charge. La taille du fichier image autorisée est de 1 Ko à 6 Mo.
  • Le rectangle « targetFace » doit contenir un visage. Zéro ou plusieurs visages seront considérés comme une erreur. Si le rectangle « targetFace » fourni n’est pas retourné à partir de « Détecter », il n’y a aucune garantie de détecter et d’ajouter le visage avec succès.
  • Une taille de visage hors détectable (36x36 - 4096x4096 pixels), une grande pose de tête ou des occlusions volumineuses entraînent des échecs.
  • La taille minimale détectable du visage est de 36 x 36 pixels dans une image ne dépassant pas 1920 x 1080 pixels. Les images dont les dimensions sont supérieures à 1920 x 1080 pixels auront besoin d’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}/facelists/{faceListId}/persistedfaces

Avec des paramètres facultatifs:

POST {endpoint}/face/{apiVersion}/facelists/{faceListId}/persistedfaces?_overload=addFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
apiVersion	path	True	string	Version d'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).
faceListId	path	True	string	Le caractère valide est une lettre en minuscules ou un chiffre ou « - » ou « _ », la longueur maximale est de 64. Modèle d’expression régulière: ^[a-z0-9-_]+$
detectionModel	query		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 ».
targetFace	query		integer[]	Rectangle de visage pour spécifier le visage cible à ajouter à une personne, au format « targetFace=left,top,width,height ».
userData	query		string	Données fournies par l’utilisateur attachées au visage. La limite de taille est de 1 000.

Corps de la demande

Media Types: "application/octet-stream"

Nom	Type	Description
imageContent	string	Image à analyser

Réponses

Nom	Type	Description
200 OK	AddFaceResult	Un appel réussi retourne un nouveauFaceId persistant.
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

Add Face to FaceList

Exemple de requête

HTTP

POST {endpoint}/face/v1.1-preview.1/facelists/your_face_list_id/persistedfaces?_overload=addFaceListFace&targetFace=10,10,100,100&detectionModel=detection_01&userData=your_user_data

"<your-image-bytes-here>"

Exemple de réponse

Code d’état:

200

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

Définitions

Nom	Description
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.

AddFaceResult

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

Nom	Type	Description
persistedFaceId	string	ID de visage persistant du visage ajouté, qui est conservé et n’expirera pas. Différent de faceId qui est créé dans « Détecter » et expirera dans les 24 heures après l’appel de détection.

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 ».

Nom	Type	Description
detection_01	string	Modèle de détection par défaut. Recommandé pour la détection de visage proche frontal. Pour les scénarios avec des visages d’angle (pose de la tête) exceptionnellement grands, des visages obstrués ou une orientation incorrecte de l’image, les visages dans de tels cas peuvent ne pas être détectés.
detection_02	string	Modèle de détection publié en mai 2019 avec une précision améliorée en particulier sur les petits visages, latéraux et flous.
detection_03	string	Modèle de détection publié en février 2021 avec une précision améliorée, en particulier sur les petits visages.

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.

Nom	Type	Description
code	string	Un des codes d’erreur définis par le serveur.
message	string	Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

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

Nom	Type	Description
error	FaceError	Objet d’erreur.