Partager via

Face List Operations - Add Large Face List Face

  • Référence
Service:
Azure AI Services
Version d'API:
v1.2-preview.1

Ajoutez un visage à une liste de visages volumineuse spécifiée, jusqu’à 1 000 000 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 grand visage » ou « Supprimer une liste de visages volumineux » 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

Note

    • Quota d’abonnement de niveau gratuit : 1 000 visages par liste de visages volumineux.
    • Quota d’abonnement de niveau S0 : 1 000 000 visages par liste de visages volumineux.
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces
Avec des paramètres facultatifs: 
POST {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}/persistedfaces?_overload=addLargeFaceListFace&targetFace={targetFace}&detectionModel={detectionModel}&userData={userData}

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).
largeFaceListId
 path True

string

Le caractère valide est la lettre en minuscules ou en chiffres ou '-' ou '_', la longueur maximale est 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 Ko.

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 nouvel objet persistedFaceId.
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 LargeFaceList

Exemple de requête

POST {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id/persistedfaces?_overload=addLargeFaceListFace&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 visage persistant du visage ajouté, qui est conservé et n’expire pas. Différent de faceId créé dans « Détecter » et expirera dans 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. Recommande de détecter les visages frontaux proches. Pour les scénarios avec des visages à angle exceptionnellement grand (pose de tête), des visages obstrués ou une orientation d’image incorrecte, 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 visages petits, côté et flou.
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 ensemble de 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.