Documentación: Acción Hugging Face (Análisis con IA)¶

Descripción General¶

La Acción Hugging Face es un nodo de automatización que permite analizar imágenes utilizando modelos de inteligencia artificial alojados en Hugging Face, la plataforma abierta de modelos de IA. Pertenece a la familia de nodos de AI Models.

En entornos IoT y de seguridad, es útil cuando deseas usar modelos abiertos o específicos (por ejemplo, modelos de visión como GLM-4.5V) para el análisis de imágenes de cámaras, con flexibilidad para elegir el modelo por su identificador.

¿Cuándo usar esta acción?¶

Utiliza esta acción cuando necesites:

Analizar imágenes de cámaras con modelos de visión alojados en Hugging Face.
Usar un modelo específico de la comunidad identificándolo por su nombre (org/modelo).
Obtener descripciones (por ejemplo, en JSON) de lo que ocurre en una imagen.

Configuración del Nodo¶

El nodo cuenta con dos pestañas de configuración en la parte superior: Formulario (Form) y Editor de JSON (JSON Editor).

Configuración vacía del nodo Hugging Face

Vista Formulario¶

1. API Key *Requerido¶

Selecciona la credencial de Hugging Face que autentica el acceso (gestionada de forma centralizada y segura).

2. Modelo (Model) *Requerido¶

El identificador del modelo de Hugging Face a utilizar, en formato organización/modelo (por ejemplo, zai-org/GLM-4.5V).

3. URLs de Imágenes (Image URLs)¶

Las URLs de las imágenes a analizar (una por línea). Admite expresiones de plantilla (por ejemplo, {{get_snapshot_node.url}}).

4. Prompt *Requerido¶

La instrucción o pregunta para el modelo. Admite expresiones de plantilla.

Formulario configurado del nodo Hugging Face

Vista Editor de JSON¶

Vista JSON Editor del nodo Hugging Face

Estructura JSON (Parámetros de entrada)¶

{
  "api_key": "",
  "resource": "image",
  "operation": "analyze",
  "model_id": "zai-org/GLM-4.5V",
  "image_urls": [
    "{{get_snapshot_node.url}}"
  ],
  "video_urls": [],
  "prompt": "Describe in JSON format what you see in this security camera image."
}

Campos del JSON¶

Campo	Tipo	Descripción
`api_key`	string	Referencia a la credencial de Hugging Face (gestionada de forma segura).
`resource`	string	Tipo de recurso (`image`).
`operation`	string	Operación (`analyze`).
`model_id`	string	ID del modelo de Hugging Face (ej. `zai-org/GLM-4.5V`).
`image_urls`	array (string)	URLs de las imágenes a analizar.
`video_urls`	array (string)	URLs de videos (si aplica).
`prompt`	string	La instrucción/pregunta para el modelo.

Output: Dónde viene la data del nodo¶

El resultado del análisis (texto generado por el modelo) queda disponible en la salida del nodo y puede usarse en nodos posteriores con {{node_key}}.

Ejemplos de uso¶

Ejemplo 1: Análisis de imagen con un modelo de visión abierto¶

Caso de uso: Analizar la captura de una cámara con un modelo de visión de Hugging Face para obtener una descripción estructurada.

Model: zai-org/GLM-4.5V
Image URLs: {{get_snapshot_node.url}}
Prompt: Describe in JSON format what you see in this security camera image.

(ver estructura JSON anterior)

Validación y errores¶

Condición	Causa / Solución habitual
Error de autenticación	La credencial de Hugging Face es inválida o sin permisos.
Modelo no encontrado	Verifica que el `model_id` (`org/modelo`) exista y sea accesible con tu token.
Las URLs no funcionan	Asegúrate de que las URLs de imagen sean accesibles públicamente.

Buenas prácticas¶

Usar credenciales centralizadas: No escribas el token de Hugging Face en el nodo.
Elegir un modelo de visión: Para analizar imágenes, selecciona un modelo multimodal/visión.
Pedir salidas estructuradas: Solicita JSON en el prompt cuando vayas a procesar el resultado en nodos posteriores.
Encadenar con la captura: Patrón típico: Obtener captura → Hugging Face → condición/notificación.