---
title: "Análisis facial"
url: https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/face-analytics/
description: "Esta página describe el método para usar la función Face Analytics para detectar rostros con criterios especificados en tu aplicación Nodejs con fragmentos de código de ejemplo"
last_updated: 2026-06-09T07:46:16Z
service: Zia Services
type: general
related_links:
  - name: "Face analytics - API"
    url: /es/api/code-reference/zia-services/face-analytics/#FaceAnalytics
---

# Face Analytics
[Zia Face Analytics](https://docs.catalyst.zoho.com/es/zia-services/help/face-analytics/introduction/) realiza detección facial en imágenes y analiza las características faciales para proporcionar información como el género, la edad y la emoción de los rostros detectados.
Debes proporcionar archivos ._jpg_/._jpeg_ o ._png_ como entrada. Consulta la [documentación de la API](https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/face-analytics/#FaceAnalytics) para los formatos de solicitud y respuesta.
El método `analyseFace()` acepta la imagen de entrada como su argumento. También puedes especificar el modo de análisis como `basic`, `moderate` o `advanced`. También puedes especificar los atributos `age`, `smile` o
`gender` como `true` para detectar o `false` para no detectar.
Estos valores son opcionales. Todos los atributos se detectan y el modo `advanced` se procesa por defecto.
La respuesta devuelve la predicción de los atributos habilitados, las coordenadas y puntos de referencia de las características faciales de cada rostro, y la puntuación de confianza de cada análisis.
La referencia `zia` utilizada a continuación se define en la
[página de instancia del componente.](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/get-component-instance)
La promesa devuelta aquí se resuelve a un objeto JSON.

```javascript
let fs = require('fs');
var zia = app.zia();
//Pasa el archivo de entrada, el modo y las características a detectar
zia.analyseFace(fs.createReadStream('./face.png'), {
mode: 'moderate',
age: true,
emotion: true,
gender: false
}).then((result) => {
console.log(result);
})
        .catch((err) => console.log(err.toString())); //Registrar errores en Catalyst Logs
```

A continuación se muestra una respuesta de ejemplo que recibirás para cada versión:

**Node JS**

```

    {
    "faces_count":1,
    "faces":[
    {
    "co_ordinates":[
    "401",
    "193",
    "494",
    "313"
    ],
    "emotion":{
    "confidence":{
    "smiling":"0.75",
    "not_smiling":"0.25"
    },
    "prediction":"smiling"
    },
    "gender":{
    },
    "confidence":1,
    "id":"0",
    "landmarks":{
    "right_eye":[
    [
    "467",
    "230"
    ]
    ],
    "nose":[
    [
    "451",
    "264"
    ]
    ],
    "mouth_right":[
    [
    "474",
    "278"
    ]
    ],
    "left_eye":[
    [
    "426",
    "239"
    ]
    ],
    "mouth_left":[
    [
    "434",
    "283"
    ]
    ]
    },
    "age":{
    "confidence":{
    "20-29":"0.73",
    "30-39":"0.08",
    "0-2":"0.0",
    "40-49":"0.0",
    "50-59":"0.0",
    ">70":"0.0",
    "60-69":"0.0",
    "10-19":"0.17",
    "3-9":"0.0"
    },
    "prediction":"20-29"
    }
    }
    ]
    }

    {
    "faces_count":1,
    "faces":[
    {
    "co_ordinates":[
    401,
    193,
    494,
    313
    ],
    "emotion":{
    "confidence":{
    "smiling":"0.75",
    "not_smiling":"0.25"
    },
    "prediction":"smiling"
    },
    "gender":{
    },
    "confidence":1,
    "id":0,
    "landmarks":{
    "right_eye":[
    [
    467,
    230
    ]
    ],
    "nose":[
    [
    451,
    264
    ]
    ],
    "mouth_right":[
    [
    474,
    278
    ]
    ],
    "left_eye":[
    [
    426,
    239
    ]
    ],
    "mouth_left":[
    [
    434,
    283
    ]
    ]
    },
    "age":{
    "confidence":{
    "20-29":"0.73",
    "30-39":"0.08",
    "0-2":"0.0",
    "40-49":"0.0",
    "50-59":"0.0",
    ">70":"0.0",
    "60-69":"0.0",
    "10-19":"0.17",
    "3-9":"0.0"
    },
    "prediction":"20-29"
    }
    }
    ]
    }

```