¿Por qué falla CLIPTextEncode con flux1-dev y funciona el FP8?

El problema del nodo CLIPTextEncode

Muchos usuarios enfrentan errores al usar modelos de IA como Flux en sus workflows de generación de imágenes. Un caso común es el error ERROR: clip input is invalid: None, que aparece específicamente cuando se carga la versión estándar de flux1-dev.safetensors.

Aunque parece un problema de configuración del software, el análisis revela una diferencia fundamental en cómo están estructurados los modelos.

Diagrama técnico comparando dos nodos de generación de imágenes: uno compatible con CLIP integrado y otro con componentes faltantes o incompatibles.
Comparativa visual entre las versiones FP8 y estándar de Flux en el workflow.

La clave: estructura del checkpoint

Los checkpoints de IA suelen dividirse en componentes separados, como el UNet y el CLIP text encoder. La versión que falla probablemente contiene solo los pesos necesarios para la red neuronal principal (el UNet), dejando fuera el modelo CLIP o presentándolo en un formato incompatible.

En contraste, la variante FP8 funciona porque está diseñada como un paquete optimizado y completo. Incluye todos los componentes necesarios embebidos de una manera que el workflow puede interpretar directamente sin necesidad de ensamblar partes externas.

Soluciones prácticas

No necesitas rehacer todo tu sistema para solucionar esto. Tienes tres caminos claros:

  • Usa la versión FP8: Si tu hardware lo soporta, esta es la opción más sencilla y estable.
  • Carga el CLIP manualmente: Si prefieres usar la versión completa, asegúrate de cargar un archivo separado para el text encoder en el nodo correspondiente.
  • Extrae y combina con Python: Puedes usar scripts con la librería safetensors para extraer los pesos del CLIP de tu modelo estándar y guardarlos como un nuevo archivo compatible.