Wan y LTX no usan el mismo sistema de preview que MiniMax H3 en ComfyUI

Si estás usando ComfyUI para generar video con modelos recientes como Wan o LTX, es probable que hayas notado algo extraño: la vista previa del latent funciona perfectamente para MiniMax H3, pero en cuanto intentas usarla con Wan o LTX, el sistema muestra un error o una imagen totalmente incomprensible.

A primera vista, podrías pensar que es un problema de compatibilidad general entre ComfyUI y estos nuevos modelos. Sin embargo, tras analizar cómo funciona la arquitectura subyacente, queda claro que **Wan y LTX no tienen por qué usar el mismo mecanismo de preview** que MiniMax H3.

El verdadero problema: ¿qué son los decodificadores TAE?

La solución clave para entender esta diferencia radica en una pieza de software específica llamada Tiny Autoencoder, o TAE. ComfyUI ya incorpora soporte nativo para previews de vídeo mediante pequeños decoders especializados, que son mucho más adecuados que intentar interpretar directamente los canales del latent.

Para tu caso concreto, la arquitectura se separa claramente según el modelo:

  • Wan 2.1 y Wan 2.2: Utilizan decoders específicos llamados TAEHV, concretamente las variantes taew2_1 para Wan 2.1 y taew2_2 para Wan 2.2.
  • LTX: Cuenta con un TAE específico llamado TAELTX, disponible como taeltx_2 o versiones más avanzadas como taeltx2_3.

Esto explica perfectamente por qué tu preview de H3 funciona: ese modelo utiliza un mecanismo basado en latent_rgb_factors, que es una proyección matemática directa. En cambio, para los modelos modernos como Wan y LTX, la solución más útil es utilizar un TAEHV específico para cada familia de latent.

Diagrama técnico comparando los modelos de IA Wan 2.1, LTX-2.3 y MiniMax H3 con sus decodificadores específicos.
Comparativa visual de los modelos Wan y LTX frente a MiniMax H3, mostrando sus respectivos decodificadores TAE y mecanismos de vista previa.

Una ventaja enorme de este enfoque es que no necesitas hacer una decodificación VAE completa con los modelos pesados en cada paso del proceso. Los TAE son autoencoders diminutos destinados precisamente a generar previews rápidas.

¿Dónde va todo esto? La estructura de archivos de ComfyUI

Aquí es donde muchos usuarios cometen el error más común: confundir la ubicación de los modelos. Es vital entender que en tu instalación existen dos directorios distintos:

  • models/vae/: Aquí se guardan los VAEs completos y pesados, como wan_2.1_vae.safetensors.
  • models/vae_approx/: Este es el directorio exclusivo para las vistas previas, donde deben colocarse los archivos TAE.

Para que el sistema funcione correctamente en tu ComfyUI 0.35.0, debes asegurarte de tener los archivos correspondientes listos en la carpeta models/vae_approx/. Por ejemplo, para Wan 2.1 necesitarías colocar taew2_1.safetensors, y para LTX-2.3 deberías usar taeltx2_3.safetensors.

Vista detallada de la estructura de carpetas models/vae y models/vae_approx en un sistema de archivos.
La estructura de archivos clave en ComfyUI, diferenciando los VAEs completos del directorio vae_approx para las vistas previas.

Es importante notar que el archivo latent_preview.py de ComfyUI ya contempla una lista interna de estos decoders, incluyendo variantes como taehv, lighttaew2_1 y taeltx_2. Sin embargo, versiones específicas pueden requerir un pequeño ajuste en ese archivo para reconocer los nuevos TAEs.

En resumen, el problema no es que el modelo falle, sino que estás intentando usar una ruta de decodificación incompatible. Al colocar los archivos correctos en la carpeta vae_approx, ComfyUI podrá interpretar correctamente los latents de Wan y LTX sin necesidad de actualizar todo tu ecosistema de software.