Detección de rostro

La función Detección de rostros de la API de Video Intelligence busca rostros en un video y muestra lo siguiente:

  • El segmento de video o los segmentos en los que se detecta un rostro en todos los videos de la solicitud determinada.

  • Opcional: cuadros delimitadores que definen el área del fotograma en el que se detecta el rostro. Para habilitar esta función, establece el campo includeBoundingBoxes en FaceDetectionConfig en True.

  • Opcional: Son los atributos detectados del rostro. Para habilitar la detección de atributos, configura el campo includeAttributes en FaceDetectionConfig como True. (nota: También debes establecer includeBoundingBoxes en True). Consulta también DetectedAttribute.

    Posibles atributos booleanos:

Atributo Descripción
headwear La persona lleva un accesorio en la cabeza, como un sombrero, una gorra o una bufanda. No incluye objetos pequeños que sostienen el cabello (p.ej., horquillas).
frontal_gaze Si los ojos de la persona miran directamente a la cámara, en lugar de que solo se vean los ojos.
eyes_visible El rostro la esclerótica (blanco del ojo) es visible para ambos ojos.
glasses La persona lleva lentes en la cara y sobre los ojos. Los lentes pueden ser transparentes o de color. Nota: Si se usan de cualquier otra manera (p.ej., en la parte superior de la cabeza o alrededor del cuello), se ignoran los lentes.
mouth_open La persona tiene la boca abierta.
smiling (obsoleta) Obsoleto: A partir del 15 de octubre de 2026, el atributo smiling dejará de estar disponible y ya no se devolverá para proyectos nuevos o proyectos sin uso reciente de la detección de rostros. A partir del 14 de enero de 2027, este atributo se quitará de forma permanente para todos los proyectos.

Para ver un ejemplo, consulta Detección de rostro.

Visualizador de la API de Video Intelligence

Consulta el visualizador de la API de Video Intelligence para ver esta función en acción.