La fonctionnalité Détection des visages de l'API Video Intelligence recherche les visages dans une vidéo et renvoie les éléments suivants :
Le ou les segments vidéo dans lesquels un visage est détecté, pour toutes les vidéos de la requête donnée.
Facultatif : les cadres de délimitation définissant la zone de l'image vidéo dans laquelle le visage est détecté. Pour activer cette fonctionnalité, définissez le champ
includeBoundingBoxesdeFaceDetectionConfigsurTrue.Facultatif : les attributs détectés pour le visage. Pour activer la détection d'attributs, définissez le champ
includeAttributesdeFaceDetectionConfigsurTrue(remarque : vous devez également définirincludeBoundingBoxessurTrue.) Consultez également la section surDetectedAttribute.Attributs booléens possibles :
| Attribut | Description |
|---|---|
headwear |
La personne porte un couvre-chef, comme un chapeau, une casquette ou un foulard. N'inclut pas les petits objets qui maintiennent les cheveux (par exemple, les épingles à cheveux). |
frontal_gaze |
La personne regarde directement la caméra, ou simplement les deux yeux de la personne sont visibles à l'image. |
eyes_visible |
La sclère (blanc de l'œil) des deux yeux est visible. |
glasses |
La personne porte des lunettes sur le visage et devant les yeux. Les lunettes peuvent être transparentes ou teintées. Remarque : Les lunettes qui sont portées de toute autre façon (par exemple sur la tête ou autour du cou) sont ignorées. |
mouth_open |
La bouche de la personne est ouverte. |
smiling (obsolète) |
Obsolète : à compter du 15 octobre 2026, l'attribut smiling est obsolète et n'est plus renvoyé pour les nouveaux projets ou les projets n'ayant pas utilisé récemment la détection de visages.
À partir du 14 janvier 2027, cet attribut sera définitivement supprimé pour tous les projets. |
Pour obtenir un exemple, consultez la page Détection de visages.
Visualiseur de l'API Video Intelligence
Utilisez le visualiseur de l'API Video Intelligence pour voir cette fonctionnalité en action.