--- title: "Análisis facial" url: https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/face-analytics/ description: "Esta API te permite realizar detección y análisis facial en un archivo de imagen y obtener las predicciones de género, edad y emoción en los rostros detectados." last_updated: 2026-06-09T07:46:16Z service: Zia Services type: api --- # 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. Face Analytics también proporciona los niveles de confianza de cada predicción de atributo que te permiten tomar decisiones informadas. Puede detectar hasta 10 rostros en una imagen y proporciona predicciones de los atributos para cada rostro detectado. # Ejecutar Face Analytics ### Descripción Puedes usar esta API para realizar detección y análisis facial en un archivo de imagen, y especificar la ruta al archivo en la solicitud de la API como se muestra en la solicitud de ejemplo. Opcionalmente puedes especificar un modo de análisis que determina la cantidad de puntos de referencia faciales a detectar en un rostro. También puedes habilitar o deshabilitar los atributos a predecir, como la emoción, la edad y el género. Esta API se usa para pasar datos de entrada para la predicción de Face Analytics. Debes pasar un archivo de imagen de entrada y los datos en formato JSON en la solicitud como se describe a continuación. ### Detalles de la Solicitud #### URL de Solicitud `POST` {api-domain}/baas/v1/project/{project_id}/ml/faceanalytics - **api-domain** (URL): El dominio específico del DC para acceder a la API de Catalyst - **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto #### Encabezados de Solicitud **Authorization:** Zoho-oauthtoken {oauth_token} **content-type:** multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW **Encabezados Opcionales** **CATALYST-ORG:** {org_id} **Environment:** Development #### Alcance ZohoCatalyst.mlkit.READ #### Propiedades del JSON de Solicitud - **file** (file, mandatory): El archivo de entrada a procesar. Debes proporcionar la ruta en tu sistema local. Formatos permitidos: *.webp, .jpeg, .png* Límite de tamaño de archivo: 10 MB - **mode** (string, optional): Indica la cantidad de puntos de referencia faciales a detectar en un rostro Valores permitidos: `basic`, `moderate`, `advanced` Valor predeterminado: `advanced` * `basic`: Detector de 0 puntos de referencia que detecta solo el contorno del rostro * `moderate`: Detector de 5 puntos de referencia que detecta- Ojos: El centro de ambos ojos, Nariz: Punta de la nariz, Labios: El centro de ambos labios * `advanced`: Detector de 68 puntos de referencia que detecta- Línea de mandíbula: Contorno del rostro, Cejas: Ceja izquierda y derecha, Ojos: Ojo izquierdo y derecho, Puente nasal, Línea de fosas nasales, Labio superior: Borde superior e inferior, Labio inferior: Borde superior e inferior - **emotion** (boolean, optional): Valores permitidos: `false`: La emoción no será detectada `true`: La emoción será detectada Valor predeterminado: `true` - **age** (boolean, optional): Valores permitidos: `false`: La edad no será detectada `true`: La edad será detectada Valor predeterminado: `true` - **gender** (boolean, optional): Valores permitidos: `false`: El género no será detectado `true`: El género será detectado Valor predeterminado: `true` ### Detalles de la Respuesta La respuesta devuelve los detalles de los puntos de referencia faciales de los rostros detectados, y las predicciones de emoción, edad y género, basadas en los parámetros y modo establecidos en la solicitud de la API en la clave `data`. La probabilidad general de las coordenadas de la detección de puntos de referencia faciales, y la probabilidad de las predicciones realizadas para los parámetros de emoción, edad y género se devolverán como puntuaciones de `confidence`. **Sample Request: Basic** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/faceanalytics \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \ -F "file=@attachment1.txt" \ -d '{ "mode": "basic", "emotion": "true", "age": "true", "gender": "true" }' ``` **Sample Response: Basic** ```json { "status": "success", "data": { "faces": [ { "confidence": 1.0, "id": 0, "co_ordinates": [ 267, 39, 153, 227 ], "emotion": { "prediction": "not_smiling", "confidence": { "smiling": "0.0", "not_smiling": "1.0" } }, "age": { "prediction": "3-9", "confidence": { "0-2": "0.005", "10-19": "0.33", "20-29": "0.12", "3-9": "0.509", "30-39": "0.032", "40-49": "0.003", "50-59": "0.0", "60-69": "0.0", ">70": "0.0" } }, "gender": { "prediction": "female", "confidence": { "female": "0.92", "male": "0.08" } } } ] } } ``` **Sample Request: Moderate** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/faceanalytics \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \ -F "file=@attachment1.txt" \ -d '{ "mode": "moderate", "emotion": "false", "age": "false", "gender": "true" }' ``` **Sample Response: Moderate** ```json { "status": "success", "data": { "faces": [ { "confidence": 1.0, "id": 0, "co_ordinates": [ 267, 39, 153, 227 ], "landmarks": { "left_eye": [337,135], "right_eye": [400,130], "nose": [ 400, 165 ], "mouth_left": [ 353, 217 ], "mouth_right": [ 404, 211 ] }, "gender": { "prediction": "female", "confidence": { "female": "0.92", "male": "0.08" } } } ] } } ``` **Sample Request: Advanced** ```bash curl -X POST \ https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/faceanalytics \ -H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \ -H "Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW" \ -F "file=@attachment1.txt" \ -d '{ "mode": "advanced", "emotion": "true", "age": "false", "gender": "false" }' ``` **Sample Response: Advanced** ```json { "status": "success", "data": { "faces": [ { "co_ordinates" : [ 185, 96, 275, 18], "confidence" : 0.99 "landmarks" : { 'mouth': [ [259, 440], [287, 423], [312, 413], [325, 418], [338, 414], [354, 424], [368, 442], [355, 461], [339, 470], [325, 472], [310, 470], [285, 460], [269, 440], [311, 435], [324, 436], [338, 436], [359, 442], [339, 440], [326, 441], [312, 439] ], 'right_eyebrow': [ [189, 245], [216, 230], [244, 227], [273, 234], [301, 248] ], 'left_eyebrow': [ [356, 249], [379, 238], [401, 232], [422, 235], [436, 252] ], 'right_eye': [ [225, 288], [245, 281], [265, 282], [280, 295], [263, 297], [244, 297] ], 'left_eye': [ [358, 299], [376, 288], [393, 290], [408, 298], [393, 305], [376, 304] ], 'nose': [ [329, 287], [331, 311], [334, 336], [337, 360], [301, 385], [315, 389], [329, 392], [341, 390], [352, 385] ], 'jaw': [ [131, 283], [136, 340], [145, 393], [158, 442], [180, 484], [212, 513], [250, 530], [287, 542], [319, 545], [347, 535], [370, 512], [393, 487], [411, 456], [423, 419], [432, 381], [437, 342], [439, 303] ] }, "emotion": { "prediction": "not_smiling", "confidence": { "smiling": "0.0", "not_smiling": "1.0" } } } ] } } ``` ### SDK Documentation [Face Analytics- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/face-analytics)

[Face Analytics- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/face-analytics)

[Face Analytics- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/zia-services/face-analytics)