---
title: "Análisis facial"
url: https://docs.catalyst.zoho.com/es/sdk/python/v1/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 Python 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
  - name: "SDK Scopes"
    url: /es/sdk/python/v1/sdk-scopes
---

# 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 un archivo .webp/.jpeg o .png como entrada al método `open()` para realizar Face Analytics en esa imagen. Esto abre el archivo proporcionado y devuelve un objeto de archivo como respuesta. 
El método `analyse_face()` 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.
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.
Para conocer más sobre la instancia de componente `zia` utilizada a continuación, consulta [esta sección de ayuda](https://docs.catalyst.zoho.com/es/sdk/python/v1/zia-services/get-component-instance/).
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.
**Parámetros utilizados**
<table class="content-table">
        <thead>
                <tr>
                        <th class="w20p">Nombre del parámetro</th>
         <th class="w20p">Tipo de dato</th>
      <th class="w60p">Definición</th>
                </tr>
        </thead>
        <tbody>
    <tr>
                <td>`img`</td>
      <td>Image</td>
                        <td>Un parámetro **obligatorio**. Almacenará la imagen del rostro a analizar.</td>
                </tr>
    <tr>
                <td>`mode`</td>
      <td>String</td>
                        <td>Un parámetro **opcional**. Almacenará los valores del modo de análisis - "basic", "moderate" o "advanced".</td>
         </tr>
      <tr>
                <td>`age`</td>
      <td>Boolean</td>
                        <td>Un parámetro **opcional**. Decidirá si determinar la edad o no. Los valores aceptados son "Yes" o "No"</td>
                </tr>
         <tr>
                <td>`emotion`</td>
      <td>Boolean</td>
                        <td>Un parámetro **opcional**. Decidirá si determinar la emoción o no. Los valores aceptados son "Yes" o "No"</td>
                </tr>
      <tr>
                <td>`gender`</td>
      <td>Boolean</td>
                        <td>Un parámetro **opcional**. Decidirá si determinar el género o no. Los valores aceptados son "True" o "False"</td>
                </tr>
        </tbody>
</table>

```python
# Implementación de Face Analytics
zia = app.zia()
img = open("sample.webp", "rb")
result = zia.analyse_face(
    img, {"mode": "moderate", "age": True, "emotion": True, "gender": False}
)

```

A continuación se muestra una respuesta de ejemplo:

```json
{
   "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"
         }
      }
   ]
}

```

> **Info :** Consulta la [tabla de SDK Scopes](https://docs.catalyst.zoho.com/es/sdk/python/v1/sdk-scopes) para determinar el nivel de permiso requerido para realizar la operación anterior.