Respuesta corta: gemma4_12b_int8_convrot.safetensors (repositorio Comfy-Org/gemma-4) carga y codifica en ComfyUI, pero no sirve como encoder de LTX-2.5. Al muestrear falla con RuntimeError: Tensors must have same number of dimensions: got 4 and 3, porque ese fichero no trae la proyección de texto que LTX-2.5 necesita. El encoder correcto es gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors (15,4 GB, repositorio Lightricks/LTX-2.5), el mismo que usa nuestra guía de LTX-2.5.
Lo comprobamos el 5 de noviembre de 2026 en una RTX 3090 con el workflow T2V de esa guía, cambiando solo el encoder.
La prueba
| Dato | Valor |
|---|---|
| GPU | RTX 3090 24 GB, 32 GB de RAM |
| ComfyUI | v0.43.2 (commit 423cbd20), PyTorch 2.10.0+cu130, solo nodos del núcleo |
| Workflow | T2V de la guía de LTX-2.5 (el JSON descargable), con CLIPLoader tipo ltxv |
| Encoder probado | gemma4_12b_int8_convrot.safetensors, 12.055.234.634 bytes |
| Transformer y VAE | ltx-2.5-22b-distilled-transformer-comfy-int8-convrot.safetensors y ltx-2.5-video-vae-bf16.safetensors |
| Clip | 960×544, 121 fotogramas, 24 fps, sigmas destilados de 8 pasos, CFG 1 |
| Prompt | A red kite flies over a green hill on a windy afternoon, static camera. |
Los tres ficheros se descargaron de Hugging Face y su SHA256 coincidía con el de la ficha de cada uno.
Paso 1: solo el encoder
Con un grafo mínimo (CLIPLoader → CLIPTextEncode) el fichero de Comfy-Org carga sin errores ni avisos y codifica el prompt en 133 s, con un pico de 14,1 GB de VRAM medido con nvidia-smi (incluye unos 2 GB del escritorio). Hasta aquí parece que todo va bien.
Pero ComfyUI no lo carga como encoder de LTX: lo identifica como un Gemma 4 genérico (Gemma4TEModel_ en el log) y devuelve los estados ocultos de todas sus capas, un tensor de 4 dimensiones. El código de ComfyUI 0.43.2 solo trata un Gemma 4 12B como encoder de LTX-2.5 si el fichero contiene la clave text_embedding_projection.video_aggregate_embed.weight, y el de Comfy-Org no la tiene.
Paso 2: el workflow completo
El grafo se ejecuta hasta el muestreo y se detiene en SamplerCustomAdvanced antes del primer paso:
RuntimeError: Tensors must have same number of dimensions: got 4 and 3
File "comfy/ldm/lightricks/embeddings_connector.py", line 290, in forward
El conector de LTX-2.5 espera el condicionamiento ya proyectado (3 dimensiones) y recibe los estados ocultos en bruto (4 dimensiones). Tiempos del log: el VAE cargó en unos 16 s, la codificación del prompt positivo y del negativo tardó unos 120 s, el transformer quedó preparado a los 148 s y el error llegó a los 150 s. No hubo falta de memoria ni salida de vídeo.
Qué no probamos ese día: repetir la ejecución con el fichero «with-proj». Esa combinación es la que documenta la guía de LTX-2.5 (ocho clips del 7 de septiembre), pero el 5 de noviembre no la volvimos a ejecutar.
Qué fichero usar con LTX-2.5
| Fichero | Repositorio | Tamaño | ¿Sirve para LTX-2.5? |
|---|---|---|---|
gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors | Lightricks/LTX-2.5, text_encoders/ | 15,4 GB | Sí: lleva la proyección |
gemma4-12b-with-proj-ltx-2.5-bf16.safetensors | Lightricks/LTX-2.5, text_encoders/ | 26,3 GB | Es la versión bf16 del anterior (no la hemos probado) |
gemma4_12b_int8_convrot.safetensors | Comfy-Org/gemma-4, text_encoders/ | 12,1 GB | No: carga, pero falla al muestrear |
Tampoco hemos encontrado una proyección de LTX-2.5 suelta para combinarla con el Gemma de Comfy-Org: los repositorios de LTX-2.5 que revisamos en Hugging Face solo la distribuyen dentro del fichero «with-proj».
Si ya descargaste el de Comfy-Org para LTX-2.5, no lo renombres: baja el de Lightricks. El de Comfy-Org tiene sentido en los workflows que piden exactamente ese nombre.
Dónde colocarlo y cómo comprobar la descarga
Los dos van en la carpeta de encoders:
ComfyUI/
└── models/
└── text_encoders/
└── gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors
Si usas una carpeta externa de modelos (extra_model_paths.yaml), comprueba que el proceso que tienes abierto lee esa ruta en vez de copiar el fichero a varios sitios.
Antes de culpar al grafo, descarta una descarga incompleta. Calcula la huella y compárala con el SHA256 de la ficha del fichero en Hugging Face:
sha256sum ComfyUI/models/text_encoders/gemma4-12b-with-proj-ltx-2.5-comfy-int8-convrot.safetensors
Si no coincide, bórralo y vuelve a descargarlo. Una página HTML guardada con extensión .safetensors o un fichero cortado también aparecen en el desplegable.
Qué revisar según el síntoma
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| El fichero no aparece en el desplegable | Carpeta equivocada o instalación distinta de la que está abierta | Revisar la ruta y extra_model_paths.yaml; ver model not found |
Carga y codifica, pero el muestreo da got 4 and 3 | Encoder sin la proyección de LTX (como el de Comfy-Org) | Usar el fichero «with-proj» de Lightricks |
| El nodo del loader sale en rojo | Falta el paquete que lo proporciona | Resolver el nodo antes de tocar pesos; ver la guía de nodos ausentes |
| La memoria se agota | Depende de la fase: carga, codificación o muestreo | Mirar en qué nodo se detiene; en nuestra guía, el encoder y el transformer no coinciden en VRAM |
Un detalle útil: el mismo mensaje got 4 and 3 aparecía ya con LTX 2.3 cuando se cargaba el Gemma sin su fichero de proyección. Si lo ves con cualquier versión de LTX, sospecha primero del encoder.
Siguientes pasos en ComfyUI
Primeros pasos
Preguntas frecuentes
- ¿ComfyUI avisa si el Gemma no es el correcto?
- No. En nuestra prueba lo aceptó sin avisos y codificó el prompt; el fallo llegó después, en el muestreo. Que el nodo cargue no demuestra que el fichero sirva para ese modelo.
- ¿Los 12,1 GB o los 15,4 GB son la VRAM que necesito?
- Son tamaños en disco. En nuestra prueba, solo con el encoder de Comfy-Org, el pico medido fue de 14,1 GB incluyendo el escritorio. Para la combinación que funciona, la guía de LTX-2.5 registró 14.612 MB en el encoder y 20.484 MB en el transformer, cargados uno detrás de otro.
- ¿Puedo usar un Gemma 4 más pequeño o un GGUF de chat?
- Con LTX-2.5, solo los ficheros con la proyección incluida. Cualquier otro Gemma, aunque ComfyUI lo cargue, llega al muestreo sin la proyección y falla igual.