Face Detection Operations - Detect

Référence

Service:: Azure AI Services

Version d'API:: v1.2-preview.1

Détecter les visages humains dans une image, retourner des rectangles de visage et éventuellement avec des faceIds, des repères et des attributs.

Important

Microsoft a mis hors service ou limité des fonctionnalités de reconnaissance faciale qui peuvent être utilisées pour tenter de déduire des états émotionnels et des attributs d’identité qui, s’ils sont mal utilisés, peuvent faire l’objet de stéréotypes, de discrimination ou de déni de services injustes. Les capacités retirées sont l’émotion et le sexe. Les capacités limitées sont l’âge, le sourire, les cheveux du visage, les cheveux et le maquillage. Adressez un e-mail à l’API Visage Azure azureface@microsoft.com si vous disposez d’un cas d’usage responsable qui tirerait parti de l’utilisation de l’une des fonctionnalités limitées. En savoir plus sur cette décision https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Aucune image ne sera stockée. Seules les fonctionnalités de visage extraites sont stockées sur le serveur. Le faceId est un identificateur de la fonctionnalité visage et sera utilisé dans « Identifier », « Vérifier » et « Rechercher similaire ». Les fonctionnalités de visage stockées expirent et sont supprimées au moment spécifié par faceIdTimeToLive après l’appel de détection d’origine.
- Les paramètres facultatifs incluent faceId, repères et attributs. Les attributs incluent headPose, lunettes, occlusion, accessoires, flou, exposition, bruit, masque et qualitéForRecognition. Certains des résultats retournés pour des attributs spécifiques peuvent ne pas être très précis.
- 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.
- 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.
- Jusqu’à 100 visages peuvent être retournés pour une image. Les visages sont classés par taille de rectangle de visage de grande à petite taille.
- Pour obtenir des résultats optimaux lors de l’interrogation de « Identifier », « Vérifier » et « Rechercher similaire » ('returnFaceId' est vrai), utilisez des visages : frontal, clair et avec une taille minimale de 200 x 200 pixels (100 pixels entre les yeux).
- 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
  - ' detection_02' : les attributs de visage et les repères sont désactivés si vous choisissez ce modèle de détection.
  - « detection_03 » : les attributs visage (masque, flou et headPose) et les repères sont pris en charge si vous choisissez ce modèle de détection.
- Différentes valeurs « recognitionModel » sont fournies. Si des opérations de suivi telles que « Verify », « Identifier », « Find Similar » sont nécessaires, spécifiez le modèle de reconnaissance avec le paramètre « recognitionModel ». La valeur par défaut de « recognitionModel » est « recognition_01 », si le dernier modèle est nécessaire, spécifiez explicitement le modèle dont vous avez besoin dans ce paramètre. Une fois spécifiés, les faceIds détectés sont associés au modèle de reconnaissance spécifié. Pour plus d’informations, reportez-vous à https://learn.microsoft.com/azure/ai-services/computer-vision/how-to/specify-recognition-model.

POST {endpoint}/face/{apiVersion}/detect

Avec des paramètres facultatifs:

POST {endpoint}/face/{apiVersion}/detect?_overload=detect&detectionModel={detectionModel}&recognitionModel={recognitionModel}&returnFaceId={returnFaceId}&returnFaceAttributes={returnFaceAttributes}&returnFaceLandmarks={returnFaceLandmarks}&returnRecognitionModel={returnRecognitionModel}&faceIdTimeToLive={faceIdTimeToLive}

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).
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 ».
faceIdTimeToLive	query		integer int32	Nombre de secondes pour l’ID de visage mis en cache. La plage prise en charge est comprise entre 60 secondes et 86400 secondes. La valeur par défaut est 86400 (24 heures).
recognitionModel	query		RecognitionModel	« recognitionModel » associé aux faceIds détectés. Les valeurs « recognitionModel » prises en charge incluent « recognition_01 », « recognition_02 », « recognition_03 » ou « recognition_04 ». La valeur par défaut est « recognition_01 ». 'recognition_04' est recommandé, car sa précision est améliorée sur les visages portant des masques par rapport à 'recognition_03', et sa précision globale est améliorée par rapport à 'recognition_01' et 'recognition_02'.
returnFaceAttributes	query		FaceAttributeType[]	Analysez et retournez l’un ou plusieurs attributs de visage spécifiés dans la chaîne séparée par des virgules, comme « returnFaceAttributes=headPose,glasses ». L’analyse des attributs visage a des coûts de calcul et de temps supplémentaires.
returnFaceId	query		boolean	Retourne les faceIds des visages détectés ou non. La valeur par défaut est true.
returnFaceLandmarks	query		boolean	Renvoyer des repères de visages des visages détectés ou non. La valeur par défaut est false.
returnRecognitionModel	query		boolean	Retournez « recognitionModel » ou non. La valeur par défaut est false. Cela s’applique uniquement lorsque returnFaceId = true.

Corps de la demande

Media Types: "application/octet-stream"

Nom	Type	Description
imageContent	string	Binaire de l’image d’entrée.

Réponses

Nom	Type	Description
200 OK	FaceDetectionResult[]	Un appel réussi retourne un tableau d’entrées de visage classées par taille de rectangle de visage dans l’ordre décroissant. Une réponse vide indique qu’aucun visage n’a été détecté.
Other Status Codes	FaceErrorResponse	Réponse d’erreur inattendue. En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

FaceDetectionResult[]

Un appel réussi retourne un tableau d’entrées de visage classées par taille de rectangle de visage dans l’ordre décroissant. Une réponse vide indique qu’aucun visage n’a été détecté.

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

Detect with Image

Exemple de requête

HTTP

POST {endpoint}/face/v1.2-preview.1/detect?_overload=detect&detectionModel=detection_01&recognitionModel=recognition_03&returnFaceId=True&returnFaceAttributes=glasses,headPose,occlusion,accessories,blur,exposure,noise,qualityForRecognition&returnFaceLandmarks=True&returnRecognitionModel=True&faceIdTimeToLive=60

"<your-image-bytes-here>"

Exemple de réponse

Code d’état:: 200

[
  {
    "faceId": "c5c24a82-6845-4031-9d5d-978df9175426",
    "recognitionModel": "recognition_03",
    "faceRectangle": {
      "width": 78,
      "height": 78,
      "left": 394,
      "top": 54
    },
    "faceLandmarks": {
      "pupilLeft": {
        "x": 412.7,
        "y": 78.4
      },
      "pupilRight": {
        "x": 446.8,
        "y": 74.2
      },
      "noseTip": {
        "x": 437.7,
        "y": 92.4
      },
      "mouthLeft": {
        "x": 417.8,
        "y": 114.4
      },
      "mouthRight": {
        "x": 451.3,
        "y": 109.3
      },
      "eyebrowLeftOuter": {
        "x": 397.9,
        "y": 78.5
      },
      "eyebrowLeftInner": {
        "x": 425.4,
        "y": 70.5
      },
      "eyeLeftOuter": {
        "x": 406.7,
        "y": 80.6
      },
      "eyeLeftTop": {
        "x": 412.2,
        "y": 76.2
      },
      "eyeLeftBottom": {
        "x": 413,
        "y": 80.1
      },
      "eyeLeftInner": {
        "x": 418.9,
        "y": 78
      },
      "eyebrowRightInner": {
        "x": 4.8,
        "y": 69.7
      },
      "eyebrowRightOuter": {
        "x": 5.5,
        "y": 68.5
      },
      "eyeRightInner": {
        "x": 441.5,
        "y": 75
      },
      "eyeRightTop": {
        "x": 446.4,
        "y": 71.7
      },
      "eyeRightBottom": {
        "x": 447,
        "y": 75.3
      },
      "eyeRightOuter": {
        "x": 451.7,
        "y": 73.4
      },
      "noseRootLeft": {
        "x": 428,
        "y": 77.1
      },
      "noseRootRight": {
        "x": 435.8,
        "y": 75.6
      },
      "noseLeftAlarTop": {
        "x": 428.3,
        "y": 89.7
      },
      "noseRightAlarTop": {
        "x": 442.2,
        "y": 87
      },
      "noseLeftAlarOutTip": {
        "x": 424.3,
        "y": 96.4
      },
      "noseRightAlarOutTip": {
        "x": 446.6,
        "y": 92.5
      },
      "upperLipTop": {
        "x": 437.6,
        "y": 105.9
      },
      "upperLipBottom": {
        "x": 437.6,
        "y": 108.2
      },
      "underLipTop": {
        "x": 436.8,
        "y": 111.4
      },
      "underLipBottom": {
        "x": 437.3,
        "y": 114.5
      }
    },
    "faceAttributes": {
      "glasses": "sunglasses",
      "headPose": {
        "roll": 2.1,
        "yaw": 3,
        "pitch": 1.6
      },
      "occlusion": {
        "foreheadOccluded": false,
        "eyeOccluded": false,
        "mouthOccluded": false
      },
      "accessories": [
        {
          "type": "headwear",
          "confidence": 0.99
        },
        {
          "type": "glasses",
          "confidence": 1
        },
        {
          "type": "mask",
          "confidence": 0.87
        }
      ],
      "blur": {
        "blurLevel": "medium",
        "value": 0.51
      },
      "exposure": {
        "exposureLevel": "goodExposure",
        "value": 0.55
      },
      "noise": {
        "noiseLevel": "low",
        "value": 0.12
      },
      "qualityForRecognition": "high"
    }
  }
]

Définitions

Nom	Description
AccessoryItem	Élément accessoire et niveau de confiance correspondant.
AccessoryType	Type de l’accessoire.
BlurLevel	Indique le niveau de flou.
BlurProperties	Propriétés décrivant toute présence de flou dans l’image.
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 ».
ExposureLevel	Indique le niveau d’exposition.
ExposureProperties	Propriétés décrivant le niveau d’exposition de l’image.
FaceAttributes	Attributs de visage pour le visage détecté.
FaceAttributeType	Analysez et retournez l’un ou plusieurs attributs de visage spécifiés dans la chaîne séparée par des virgules, comme « returnFaceAttributes=headPose,glasses ». L’analyse des attributs visage a des coûts de calcul et de temps supplémentaires.
FaceDetectionResult	Réponse pour détecter l’API.
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.
FaceLandmarks	Collection de repères de visages de 27 points point pointant vers les positions importantes des composants du visage.
FaceRectangle	Rectangle dans lequel un visage peut être trouvé.
FacialHair	Propriétés décrivant les attributs des cheveux du visage.
GlassesType	Type de lunettes du visage.
HairColor	Tableau de couleurs candidates et niveau de confiance en présence de chacun d’eux.
HairColorType	Nom de la couleur des cheveux.
HairProperties	Propriétés décrivant les attributs de cheveux.
HeadPose	3D roll/yaw/pitch angles pour la direction du visage.
LandmarkCoordinate	Coordonnées de repère dans une image.
MaskProperties	Propriétés décrivant la présence d’un masque sur un visage donné.
MaskType	Type du masque.
NoiseLevel	Indique le niveau de bruit.
NoiseProperties	Propriétés décrivant le niveau de bruit de l’image.
OcclusionProperties	Propriétés décrivant les occlusions sur un visage donné.
QualityForRecognition	Indique la qualité de l’image pour la reconnaissance.
RecognitionModel	Modèle de reconnaissance pour le visage.

AccessoryItem

Élément accessoire et niveau de confiance correspondant.

Nom	Type	Description
confidence	number	Niveau de confiance du type d’accessoire. Plage comprise entre [0,1].
type	AccessoryType	Type de l’accessoire.

AccessoryType

Type de l’accessoire.

Nom	Type	Description
glasses	string	Lunettes.
headwear	string	Porter la tête.
mask	string	Masque.

BlurLevel

Indique le niveau de flou.

Nom	Type	Description
high	string	Niveau flou élevé.
low	string	Faible niveau de flou.
medium	string	Niveau de flou moyen.

BlurProperties

Propriétés décrivant toute présence de flou dans l’image.

Nom	Type	Description
blurLevel	BlurLevel	Valeur d’énumération indiquant le niveau de flou.
value	number	Nombre indiquant un niveau de flou allant de 0 à 1.

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.

ExposureLevel

Indique le niveau d’exposition.

Nom	Type	Description
goodExposure	string	Bon niveau d’exposition.
overExposure	string	Niveau d’exposition élevé.
underExposure	string	Faible niveau d’exposition.

ExposureProperties

Propriétés décrivant le niveau d’exposition de l’image.

Nom	Type	Description
exposureLevel	ExposureLevel	Valeur d’énumération indiquant le niveau d’exposition.
value	number	Nombre indiquant le niveau d’exposition compris entre 0 et 1. [0, 0,25) est en cours d’exposition. [0,25, 0,75) est une bonne exposition. [0,75, 1] est sur-exposé.

FaceAttributes

Attributs de visage pour le visage détecté.

Nom	Type	Description
accessories	AccessoryItem[]	Propriétés décrivant tous les accessoires sur un visage donné.
age	number	Âge en années.
blur	BlurProperties	Propriétés décrivant toute présence de flou dans l’image.
exposure	ExposureProperties	Propriétés décrivant le niveau d’exposition de l’image.
facialHair	FacialHair	Propriétés décrivant les attributs des cheveux du visage.
glasses	GlassesType	Lunettes type si l’un des visages.
hair	HairProperties	Propriétés décrivant les attributs de cheveux.
headPose	HeadPose	3D roll/yaw/pitch angles pour la direction du visage.
mask	MaskProperties	Propriétés décrivant la présence d’un masque sur un visage donné.
noise	NoiseProperties	Propriétés décrivant le niveau de bruit de l’image.
occlusion	OcclusionProperties	Propriétés décrivant les occlusions sur un visage donné.
qualityForRecognition	QualityForRecognition	Propriétés décrivant la qualité globale de l’image concernant l’utilisation de l’image dans la détection est de qualité suffisante pour tenter la reconnaissance faciale.
smile	number	Intensité du sourire, nombre compris entre [0,1].

FaceAttributeType

Analysez et retournez l’un ou plusieurs attributs de visage spécifiés dans la chaîne séparée par des virgules, comme « returnFaceAttributes=headPose,glasses ». L’analyse des attributs visage a des coûts de calcul et de temps supplémentaires.

Nom	Type	Description
accessories	string	Accessoires autour du visage, y compris 'headwear', 'lunettes' et 'mask'. Tableau vide signifie qu’aucun accessoire n’est détecté. Notez qu’il s’agit d’une fois qu’un visage est détecté. Un masque volumineux peut entraîner la détection d’aucun visage.
age	string	Âge en années.
blur	string	Le visage est flou ou non. Le niveau renvoie « Low », « Medium » ou « High ». La valeur retourne un nombre compris entre [0,1], plus le flou est élevé.
exposure	string	Niveau d’exposition du visage. Level retourne « GoodExposure », « OverExposure » ou « UnderExposure ».
facialHair	string	Propriétés décrivant les attributs des cheveux du visage.
glasses	string	Type de lunettes. Les valeurs incluent « NoGlasses », « ReadingGlasses », « Lunettes de soleil », « SwimmingGoggles ».
hair	string	Propriétés décrivant les attributs de cheveux.
headPose	string	3D roll/yaw/pitch angles pour la direction du visage.
mask	string	Indique si chaque visage porte un masque. Le type de masque renvoie « noMask », « faceMask », « otherMaskOrOcclusion » ou « incertain ». La valeur retourne un « nezAndMouthCovered » booléen indiquant si le nez et la bouche sont couverts.
noise	string	Niveau de bruit des pixels de visage. Le niveau retourne « Low », « Medium » et « High ». La valeur retourne un nombre compris entre [0,1], plus la valeur est élevée
occlusion	string	Indique si chaque zone faciale est obstruée, y compris le front, les yeux et la bouche.
qualityForRecognition	string	La qualité globale de l’image concernant l’utilisation de l’image dans la détection est suffisante pour tenter la reconnaissance faciale. La valeur est une évaluation informelle de faible, moyen ou élevé. Seules les images de haute qualité sont recommandées pour l’inscription et la qualité des personnes au niveau ou supérieur à « moyen » sont recommandées pour les scénarios d’identification. L’attribut est disponible uniquement lors de l’utilisation de modèles de reconnaissance recognition_03 ou de recognition_04.
smile	string	Intensité du sourire, nombre compris entre [0,1].

FaceDetectionResult

Réponse pour détecter l’API.

Nom	Type	Description
faceAttributes	FaceAttributes	Attributs de visage pour le visage détecté.
faceId	string	FaceId unique du visage détecté, créé par l’API de détection et expire 24 heures après l’appel de détection. Pour renvoyer cela, le paramètre « returnFaceId » doit être true.
faceLandmarks	FaceLandmarks	Tableau de points de repère de visages de 27 points point pointant vers les positions importantes des composants du visage. Pour renvoyer cela, le paramètre « returnFaceLandmarks » doit être true.
faceRectangle	FaceRectangle	Zone rectangle de l’emplacement du visage sur l’image.
recognitionModel	RecognitionModel	« recognitionModel » associé à ce faceId. Cela n’est retourné que lorsque « returnRecognitionModel » est explicitement défini comme true.

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.

FaceLandmarks

Collection de repères de visages de 27 points point pointant vers les positions importantes des composants du visage.

Nom	Type	Description
eyeLeftBottom	LandmarkCoordinate	Coordonnées du bas de l’œil gauche.
eyeLeftInner	LandmarkCoordinate	Coordonnées de l’œil gauche intérieur.
eyeLeftOuter	LandmarkCoordinate	Coordonnées de l’œil gauche à l’extérieur.
eyeLeftTop	LandmarkCoordinate	Coordonnées du haut de l’œil gauche.
eyeRightBottom	LandmarkCoordinate	Coordonnées du bas de l’œil droit.
eyeRightInner	LandmarkCoordinate	Coordonnées de l’œil droit intérieur.
eyeRightOuter	LandmarkCoordinate	Coordonnées de l’œil droit extérieur.
eyeRightTop	LandmarkCoordinate	Coordonnées du haut de l’œil droit.
eyebrowLeftInner	LandmarkCoordinate	Coordonnées du sourcil gauche à l’intérieur.
eyebrowLeftOuter	LandmarkCoordinate	Coordonnées de l’extérieur du sourcil gauche.
eyebrowRightInner	LandmarkCoordinate	Coordonnées du sourcil droit à l’intérieur.
eyebrowRightOuter	LandmarkCoordinate	Coordonnées de l’extérieur du sourcil droit.
mouthLeft	LandmarkCoordinate	Coordonnées de la bouche à gauche.
mouthRight	LandmarkCoordinate	Coordonnées de la bouche à droite.
noseLeftAlarOutTip	LandmarkCoordinate	Les coordonnées du nez ont laissé l’extrémité arrière de l’alar.
noseLeftAlarTop	LandmarkCoordinate	Coordonnées du nez vers le haut de l’alar gauche.
noseRightAlarOutTip	LandmarkCoordinate	Coordonnées du nez vers l’extrémité arrière droite du nez.
noseRightAlarTop	LandmarkCoordinate	Coordonnées du nez en haut de l’alar droit.
noseRootLeft	LandmarkCoordinate	Coordonnées de la racine du nez à gauche.
noseRootRight	LandmarkCoordinate	Coordonnées de la racine du nez à droite.
noseTip	LandmarkCoordinate	Coordonnées de l’extrémité du nez.
pupilLeft	LandmarkCoordinate	Coordonnées de l’élève de l’œil gauche.
pupilRight	LandmarkCoordinate	Coordonnées de l’élève de l’œil droit.
underLipBottom	LandmarkCoordinate	Coordonnées du bas des lèvres.
underLipTop	LandmarkCoordinate	Coordonnées du haut des lèvres sous la lèvre.
upperLipBottom	LandmarkCoordinate	Coordonnées du bas de la lèvre supérieure.
upperLipTop	LandmarkCoordinate	Coordonnées du haut de la lèvre supérieure.

FaceRectangle

Rectangle dans lequel un visage peut être trouvé.

Nom	Type	Description
height	integer	Hauteur du rectangle, en pixels.
left	integer	Distance du bord gauche si l’image au bord gauche du rectangle, en pixels.
top	integer	Distance du bord supérieur si l’image au bord supérieur du rectangle, en pixels.
width	integer	Largeur du rectangle, en pixels.

FacialHair

Propriétés décrivant les attributs des cheveux du visage.

Nom	Type	Description
beard	number	Nombre compris entre 0 et 1 indiquant un niveau de confiance associé à une propriété.
moustache	number	Nombre compris entre 0 et 1 indiquant un niveau de confiance associé à une propriété.
sideburns	number	Nombre compris entre 0 et 1 indiquant un niveau de confiance associé à une propriété.

GlassesType

Type de lunettes du visage.

Nom	Type	Description
noGlasses	string	Pas de lunettes sur le visage.
readingGlasses	string	Lunettes normales sur le visage.
sunglasses	string	Lunettes de soleil sur le visage.
swimmingGoggles	string	Des lunettes de natation sur le visage.

HairColor

Tableau de couleurs candidates et niveau de confiance en présence de chacun d’eux.

Nom	Type	Description
color	HairColorType	Nom de la couleur des cheveux.
confidence	number	Niveau de confiance de la couleur. Plage comprise entre [0,1].

HairColorType

Nom de la couleur des cheveux.

Nom	Type	Description
black	string	Noir.
blond	string	Blond.
brown	string	Marron.
gray	string	Gris.
other	string	Autre.
red	string	Rouge.
unknown	string	Inconnu.
white	string	Blanc.

HairProperties

Propriétés décrivant les attributs de cheveux.

Nom	Type	Description
bald	number	Nombre décrivant le niveau de confiance de savoir si la personne est chauve.
hairColor	HairColor[]	Tableau de couleurs candidates et niveau de confiance en présence de chacun d’eux.
invisible	boolean	Valeur booléenne décrivant si les cheveux sont visibles dans l’image.

HeadPose

3D roll/yaw/pitch angles pour la direction du visage.

Nom	Type	Description
pitch	number	Valeur des angles.
roll	number	Valeur des angles.
yaw	number	Valeur des angles.

LandmarkCoordinate

Coordonnées de repère dans une image.

Nom	Type	Description
x	number	Composant horizontal, en pixels.
y	number	Composant vertical, en pixels.

MaskProperties

Propriétés décrivant la présence d’un masque sur un visage donné.

Nom	Type	Description
noseAndMouthCovered	boolean	Valeur booléenne indiquant si le nez et la bouche sont couverts.
type	MaskType	Type du masque.

MaskType

Type du masque.

Nom	Type	Description
faceMask	string	Masque facial.
noMask	string	Pas de masque.
otherMaskOrOcclusion	string	Autres types de masque ou d’occlusion.
uncertain	string	Incertain.

NoiseLevel

Indique le niveau de bruit.

Nom	Type	Description
high	string	Niveau de bruit élevé.
low	string	Faible niveau de bruit.
medium	string	Niveau de bruit moyen.

NoiseProperties

Propriétés décrivant le niveau de bruit de l’image.

Nom	Type	Description
noiseLevel	NoiseLevel	Valeur d’énumération indiquant le niveau de bruit.
value	number	Nombre indiquant le niveau de bruit compris entre 0 et 1. [0, 0,25) est en cours d’exposition. [0,25, 0,75) est une bonne exposition. [0,75, 1] est sur-exposé. [0, 0,3) est faible niveau de bruit. [0.3, 0.7) est le niveau de bruit moyen. [0,7, 1] est un niveau de bruit élevé.

OcclusionProperties

Propriétés décrivant les occlusions sur un visage donné.

Nom	Type	Description
eyeOccluded	boolean	Valeur booléenne indiquant si les yeux sont obstrués.
foreheadOccluded	boolean	Valeur booléenne indiquant si le front est obstrué.
mouthOccluded	boolean	Valeur booléenne indiquant si la bouche est obstruée.

QualityForRecognition

Indique la qualité de l’image pour la reconnaissance.

Nom	Type	Description
high	string	Haute qualité.
low	string	Qualité faible.
medium	string	Qualité moyenne.

RecognitionModel

Modèle de reconnaissance pour le visage.

Nom	Type	Description
recognition_01	string	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	string	Modèle de reconnaissance publié en mars 2019.
recognition_03	string	Modèle de reconnaissance publié en mai 2020.
recognition_04	string	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.

Partager via

Face Detection Operations - Detect

Paramètres URI

Corps de la demande

Réponses

Sécurité

Ocp-Apim-Subscription-Key

AADToken

Étendues

Exemples

Detect with Image

Exemple de requête

Exemple de réponse

Définitions

AccessoryItem

AccessoryType

BlurLevel

BlurProperties

DetectionModel

ExposureLevel

ExposureProperties

FaceAttributes

FaceAttributeType

FaceDetectionResult

FaceError

FaceErrorResponse

FaceLandmarks

FaceRectangle

FacialHair

GlassesType

HairColor

HairColorType

HairProperties

HeadPose

LandmarkCoordinate

MaskProperties

MaskType

NoiseLevel

NoiseProperties

OcclusionProperties

QualityForRecognition

RecognitionModel

Ressources supplémentaires