Face Detection Operations - Detect

Référence

Service:: Azure AI Services

API Version:: v1.1-preview.1

Détectez les visages humains dans une image, retournez des rectangles de visage et éventuellement des faceId, des points de repère et des attributs.

Important

Pour atténuer les abus potentiels qui peuvent exposer des personnes à des stéréotypes, à la discrimination ou à un déni injuste de services, nous mettons hors service les attributs de l’API Visage qui prédisent l’émotion, le sexe, l’âge, le sourire, les cheveux et le maquillage. En savoir plus sur cette décision https://azure.microsoft.com/blog/responsible-ai-investments-and-safeguards-for-facial-recognition/.

- Aucune image n’est stockée. Seules les fonctionnalités de visage extraites seront stockées sur le serveur. FaceId est un identificateur de la fonctionnalité de visage et sera utilisé dans « Identifier », « Vérifier » et « Rechercher similaire ». Les fonctionnalités de visage stockées expirent et sont supprimées à l’heure spécifiée par faceIdTimeToLive après l’appel de détection d’origine.
- Les paramètres facultatifs incluent faceId, les points de repère et les attributs. Les attributs incluent headPose, lunettes, occlusion, accessoires, flou, exposition, bruit, masque et qualityForRecognition. Certains des résultats retournés pour des attributs spécifiques peuvent ne pas être très précis.
- Les formats JPEG, PNG, GIF (la première image) et BMP sont pris en charge. La taille du 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 ne dépassant pas 1920 x 1 080 pixels. Les images dont les dimensions sont supérieures à 1920 x 1 080 pixels nécessitent une taille de visage minimale proportionnellement supérieure.
- Jusqu’à 100 visages peuvent être retournés pour une image. Les visages sont classés par taille du rectangle du visage dans l’ordre décroissant.
- Pour obtenir des résultats optimaux lors de l’interrogation de « Identifier », « Vérifier » et « Rechercher similaire » ('returnFaceId' est vrai), utilisez des visages qui sont : frontaux, clairs 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 points de repère sont désactivés si vous choisissez ce modèle de détection.
  - ' detection_03' : les attributs de visage (masque, flou et headPose) et les points de repère 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

With optional parameters:

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 d'API
endpoint	path	True	string uri	Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{resource-name}.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. Plage prise en charge de 60 secondes à 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 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 de 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 ou non les points de repère des visages détectés. La valeur par défaut est false.
returnRecognitionModel	query		boolean	Retourne « 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. Headers 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.

Headers

x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
In: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flow: accessCode
Authorization URL: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Scopes

Nom	Description
https://cognitiveservices.azure.com/.default

Exemples

Detect with Image

Sample Request

HTTP

POST {endpoint}/face/v1.1-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>"

Sample Response

Status code:: 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 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 l’API de détection.
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 points de repère de visage à 27 points 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 de niveau de confiance en présence de chacune d’elles.
HairColorType	Nom de la couleur des cheveux.
HairProperties	Propriétés décrivant des attributs de cheveux.
HeadPose	Angles de roulis/lacet/tangage 3D 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 du 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	Port de la tête.
mask	string	Masque.

BlurLevel

Indique le niveau de flou.

Nom	Type	Description
high	string	Niveau de 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. 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.

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 sous exposition. [0,25, 0,75) est une bonne exposition. [0,75, 1] est surexposition.

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	L’â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	Type de lunettes si l’un des visages.
hair	HairProperties	Propriétés décrivant des attributs de cheveux.
headPose	HeadPose	Angles de roulis/lacet/tangage 3D 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 si l’image utilisée dans la détection est d’une qualité suffisante pour tenter la reconnaissance faciale.
smile	number	Intensité du sourire, un nombre compris entre [0,1].

FaceAttributeType

Analysez et retournez 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'. Un 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 de grande taille peut entraîner la détection d’aucun visage.
age	string	L’âge en années.
blur	string	Visage est flou ou non. Level retourne 'Low', 'Medium' ou 'High'. La valeur retourne un nombre compris entre [0,1], plus le flou est grand.
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 lunettes. Les valeurs incluent « NoGlasses », « ReadingGlasses », « Lunettes de soleil », « SwimmingGoggles ».
hair	string	Propriétés décrivant des attributs de cheveux.
headPose	string	Angles de roulis/lacet/tangage 3D pour la direction du visage.
mask	string	Si chaque visage porte un masque. Le type de masque renvoie « noMask », « faceMask », « otherMaskOrOcclusion » ou « uncertain ». Value retourne une valeur booléenne « noseAndMouthCovered » indiquant si le nez et la bouche sont couverts.
noise	string	Niveau de bruit des pixels du visage. Level retourne 'Low', 'Medium' et 'High'. La valeur retourne un nombre compris entre [0,1], plus le bruit est grand
occlusion	string	Si chaque zone faciale est obstruée, y compris le front, les yeux et la bouche.
qualityForRecognition	string	Qualité globale de l’image indiquant si l’image utilisée dans la détection est d’une qualité suffisante pour tenter la reconnaissance faciale. La valeur est une évaluation informelle de faible, moyenne ou élevée. Seules les images de haute qualité sont recommandées pour l’inscription de personnes et la qualité supérieure ou supérieure à « moyenne » est recommandée pour les scénarios d’identification. L’attribut n’est disponible que lorsque vous utilisez des modèles de reconnaissance recognition_03 ou recognition_04.
smile	string	Intensité du sourire, un nombre compris entre [0,1].

FaceDetectionResult

Réponse pour l’API de détection.

Nom	Type	Description
faceAttributes	FaceAttributes	Attributs visage pour le visage détecté.
faceId	string	FaceId unique du visage détecté, créé par l’API de détection et il expirera 24 heures après l’appel de détection. Pour renvoyer cela, le paramètre « returnFaceId » doit avoir la valeur true.
faceLandmarks	FaceLandmarks	groupe de 27 points de repère du visage pointant vers les positions importantes des composants du visage. Pour retourner cela, le paramètre « returnFaceLandmarks » doit avoir la valeur true.
faceRectangle	FaceRectangle	Zone rectangle pour l’emplacement du visage sur l’image.
recognitionModel	RecognitionModel	« recognitionModel » associé à ce faceId. Cette valeur n’est retournée que lorsque « returnRecognitionModel » est explicitement défini sur 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 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.

FaceLandmarks

Collection de points de repère de visage à 27 points 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 interne.
eyeLeftOuter	LandmarkCoordinate	Coordonnées de l’œil gauche externe.
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 interne.
eyeRightOuter	LandmarkCoordinate	Coordonnées de l’œil droit externe.
eyeRightTop	LandmarkCoordinate	Coordonnées du haut de l’œil droit.
eyebrowLeftInner	LandmarkCoordinate	Coordonnées du sourcil gauche à l’intérieur.
eyebrowLeftOuter	LandmarkCoordinate	Coordonnées du sourcil gauche externe.
eyebrowRightInner	LandmarkCoordinate	Coordonnées du sourcil droit interne.
eyebrowRightOuter	LandmarkCoordinate	Coordonnées du sourcil droit externe.
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é alar vers l’extérieur.
noseLeftAlarTop	LandmarkCoordinate	Coordonnées du nez gauche en haut.
noseRightAlarOutTip	LandmarkCoordinate	Coordonnées de la pointe alar droite du nez.
noseRightAlarTop	LandmarkCoordinate	Coordonnées du nez vers le haut droit alar.
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 la pupille de l’œil gauche.
pupilRight	LandmarkCoordinate	Coordonnées de la pupille de l’œil droit.
underLipBottom	LandmarkCoordinate	Coordonnées du dessous de la lèvre inférieure.
underLipTop	LandmarkCoordinate	Coordonnées du sous-dessus de 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 se trouve sur le bord gauche du rectangle, en pixels.
top	integer	Distance entre le bord supérieur si l’image et le 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	Lunettes de nage sur le visage.

HairColor

Tableau de couleurs candidates et de niveau de confiance en présence de chacune d’elles.

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	Blonde.
brown	string	Marron.
gray	string	Gris.
other	string	Autre.
red	string	Rouge.
unknown	string	Inconnu.
white	string	Blanc

HairProperties

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

Nom	Type	Description
bald	number	Nombre décrivant le niveau de confiance pour déterminer si la personne est chauve.
hairColor	HairColor[]	Tableau de couleurs candidates et de niveau de confiance en présence de chacune d’elles.
invisible	boolean	Valeur booléenne indiquant si le cheveu est visible dans l’image.

HeadPose

Angles de roulis/lacet/tangage 3D 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.
noMask	string	Aucun 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 sous exposition. [0,25, 0,75) est une bonne exposition. [0,75, 1] est surexposition. [0, 0,3) est un niveau de bruit faible. [0.3, 0.7) est un 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	Qualité élevée.
low	string	Qualité médiocre.
medium	string	Qualité moyenne.

RecognitionModel

Modèle de reconnaissance du visage.

Nom	Type	Description
recognition_01	string	Modèle de reconnaissance par défaut pour « Détecter ». Tous les 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 la reconnaissance.

Partager via

Face Detection Operations - Detect

Paramètres URI

Corps de la demande

Réponses

Sécurité

Ocp-Apim-Subscription-Key

AADToken

Scopes

Exemples

Detect with Image

Sample Request

Sample Response

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