--- title: "Implementación" url: https://docs.catalyst.zoho.com/es/zia-services/help/face-analytics/implementation/ description: "Face Analytics es un microservicio preintegrado impulsado por Zia AI que realiza detección facial y predice varios atributos faciales." last_updated: 2026-08-17T12:16:04Z service: Zia Services type: general --- # Implementación Esta sección solo cubre el trabajo con Face Analytics en la consola de Catalyst. Consulta las secciones de documentación del [SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/face-analytics/) y la [API](https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/face-analytics/#FaceAnalytics/) para implementar Face Analytics en el código de tu aplicación. Como se mencionó anteriormente, puedes acceder a las plantillas de código que te permitirán integrar Face Analytics en tu aplicación de Catalyst desde la consola, y también probar la función subiendo imágenes con rostros y obteniendo los resultados. ### Acceder a Face Analytics Para acceder a Face Analytics en tu consola de Catalyst: 1. Navega a **Zia Services** en el panel izquierdo de la consola de Catalyst y haz clic en **Face Analytics.** ![face-analytics](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/face-analytics-updated.webp) 2. Haz clic en **Try a Demo** y esto abrirá la función Face Analytics. ![catalyst_facean_test_page](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_test_page.webp) ### Probar Face Analytics en la consola de Catalyst Puedes probar Face Analytics seleccionando una imagen de muestra de Catalyst o subiendo tu propia imagen. Para escanear una imagen de muestra con un rostro y ver el resultado: 1. Haz clic en **Select a Sample Image** en el cuadro. ![catalyst_facean_sample](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample.webp) 2. Selecciona una imagen de las muestras proporcionadas. ![catalyst_facean_select_sample](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_select_sample.webp) Face Analytics escaneará la imagen en busca de rostros, analizará y predecirá los [atributos](https://docs.catalyst.zoho.com/es/zia-services/help/face-analytics/key-concepts), y proporcionará un resultado textual del análisis y el nivel de confianza de cada predicción en valores porcentuales, para cada rostro detectado. ![catalyst_facean_sample_scanned](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample_scanned.webp) Los colores en las barras de respuesta indican el rango del porcentaje de confianza de una predicción como: rojo: 0-30%, naranja: 30-80%, verde: 80-100%. Las coordenadas generales y las coordenadas de los puntos de referencia localizados de cada rostro se proporcionan, además de las otras detecciones, en la respuesta JSON en el modo de localización de puntos de referencia avanzado por defecto. Haz clic en **View Response** para ver la [respuesta JSON](https://docs.catalyst.zoho.com/es/zia-services/help/face-analytics/key-concepts/#response-format). ![catalyst_facean_sample_json](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_sample_json.webp) Puedes consultar la [documentación de la API](https://docs.catalyst.zoho.com/es/api/code-reference/zia-services/face-analytics/#FaceAnalytics/) para ver una estructura completa de respuesta JSON de muestra. Para subir tu propia imagen y probar Face Analytics: 1. Haz clic en **Upload** en la sección _Result_. ![catalyst_facean_upload](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_upload.webp) Si estás abriendo Face Analytics después de haberlo cerrado, haz clic en **Browse Files** en este cuadro. ![catalyst_facean_browse](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_browse.webp) 2. Sube un archivo desde tu sistema local. > **Nota:** El archivo debe estar en formato ._jpg_/._jpeg_ o ._png_. El tamaño del archivo no debe exceder 10 MB. La consola escaneará la imagen en busca de rostros y mostrará el análisis de los cuatro atributos de los rostros detectados. ![catalyst_facean_image_scanned](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_image_scanned.webp) Como se mencionó anteriormente, Face Analytics puede detectar y analizar los atributos de hasta 10 rostros en una imagen. Puedes verificar los resultados de cada rostro detectado haciendo clic en las flechas laterales. La respuesta JSON también contiene los resultados de cada rostro detectado. ![catalyst/catalyst_facean_image_json](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_image_json.webp) ### Acceder a plantillas de código para Face Analytics Puedes implementar Face Analytics en tu aplicación de Catalyst usando las plantillas de código proporcionadas por Catalyst para las plataformas [Java](https://docs.catalyst.zoho.com/es/sdk/java/v1/zia-services/face-analytics/), [Node.js](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/zia-services/face-analytics/) y [Python](https://docs.catalyst.zoho.com/es/sdk/python/v1/zia-services/face-analytics/). Puedes acceder a ellas desde la sección debajo de la ventana de pruebas. Haz clic en la pestaña **Java SDK**, **NodeJS SDK** o **Python SDK**, y copia el código usando el icono de copiar. Puedes pegar este código en el código de tu aplicación web o Android donde lo necesites. ![catalyst_facean_java](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_java_updated.webp) Puedes procesar el archivo de entrada como un nuevo `File` en Java. El módulo `ZCFaceAnalyticsOptions` te proporciona la opción de habilitar o deshabilitar el análisis de cada atributo. Por ejemplo, si estableces `setAgeNeeded` como `false`, Face Analytics no proporcionará los resultados de predicción de edad para los rostros detectados en la imagen. También puedes establecer el modo de [localización de puntos de referencia](https://docs.catalyst.zoho.com/es/zia-services/help/face-analytics/key-concepts/#facial-landmark-localization) como `BASIC`, `MODERATE` o `ADVANCED` usando `setAnalyseMode`. ![catalyst_facean_node](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_node_updated.webp) En Node.js, el objeto `facePromise` se usa para contener el archivo de imagen de entrada y las opciones configuradas para él. Puedes especificar el `mode` como `basic`, `moderate` o `advanced`, y establecer un atributo como `true` o `false` para habilitar o deshabilitar el análisis del mismo. ![catalyst_facean_python](https://catalyst-docs-development.zohostratus.in/images/help/face-analytics/catalyst_facean_python.webp) En Python, 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.