# taeh3_2d_kijai.safetensors

> TAEH3 2D by Kijai · 2D preview decoder for MiniMax H3

taeh3_2d_kijai.safetensors is Kijai’s 2D tiny VAE for MiniMax H3 previews, renamed so it does not overwrite madebyollin’s taeh3.safetensors. Put it in ComfyUI/models/vae_approx and select it in your preview node.

Kijai’s own repo ships this file as vae_approx/taeh3.safetensors. Rename it to taeh3_2d_kijai.safetensors after downloading, or use the pre-renamed copy below.

## Facts

- **Same file as:** taeh3.safetensors (Kijai/MiniMax-H3-TAE)
- **Type:** Tiny VAE (preview decoder)
- **Format:** Safetensors
- **Size:** 9.8 MB (9,791,388 bytes)
- **SHA256:** f0f60fa072089997f817402098c2fd90777cb2660dd79cf5df42fc1e3e08e527
- **ComfyUI folder:** ComfyUI/models/vae_approx/
- **Loader node:** Model Preview Override
- **License:** Apache-2.0

## What is taeh3_2d_kijai.safetensors?

Kijai trained this small 2D decoder soon after MiniMax H3 came out, so ComfyUI could show real-color previews instead of Latent2RGB smudges. It decodes each latent frame on its own, so previews look like a slideshow of stills rather than smooth motion.

Its original name, taeh3.safetensors, clashes with madebyollin’s later temporal TAEH3, a different and better model. t8star’s Taeh3-Comfy pack renamed Kijai’s file to taeh3_2d_kijai.safetensors without changing the tensors, and that name is what most guides now use.

## Download and install

- [Hugging Face · t8star/Taeh3-Comfy](https://huggingface.co/t8star/Taeh3-Comfy/resolve/main/models/vae_approx/taeh3_2d_kijai.safetensors) · saves as `taeh3_2d_kijai.safetensors` · Pre-renamed copy, tensors unchanged.
- [Hugging Face · Kijai/MiniMax-H3-TAE](https://huggingface.co/Kijai/MiniMax-H3-TAE/resolve/main/vae_approx/taeh3.safetensors) · saves as `taeh3.safetensors` · Original upload. Rename after download.

```sh
cd ComfyUI/models/vae_approx
wget -O taeh3_2d_kijai.safetensors \
  https://huggingface.co/t8star/Taeh3-Comfy/resolve/main/models/vae_approx/taeh3_2d_kijai.safetensors
sha256sum taeh3_2d_kijai.safetensors
# f0f60fa072089997f817402098c2fd90777cb2660dd79cf5df42fc1e3e08e527
```

Safetensors files hold tensors only and cannot run code. Still compare the SHA256: a failed download often leaves an HTML error page saved under the model’s filename.

## How to load it in ComfyUI

TAEH3 does not touch your final video. It only decodes sampler previews. Model Preview Override from KJNodes reads it from models/vae_approx and patches the MODEL before your sampler.

- **Turn previews on:** Set ComfyUI’s preview method to auto or TAESD so the sampler shows them.
- **Final output unchanged:** The full video VAE still decodes the result. TAEH3 only speeds up previews.

## Files a MiniMax H3 video workflow needs

Use the Ref2VA diffusion model instead of FL2VA for reference-to-video workflows.

- [`minimax_h3_fl2va_pruned_int8_convrot.safetensors`](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors) · Diffusion model (FL2VA) · `models/diffusion_models/` · 20.97 GB
- [`qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors`](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors) · Text encoder (Qwen3-VL 32B) · `models/text_encoders/` · 15.69 GB
- [`minimax_h3_video_vae_fp16.safetensors`](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_video_vae_fp16.safetensors) · Video VAE · `models/vae/` · 5.21 GB
- [`minimax_h3_audio_vae_fp32.safetensors`](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/vae/minimax_h3_audio_vae_fp32.safetensors) · Audio VAE · `models/vae/` · 605 MB
- [`minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors`](https://huggingface.co/Comfy-Org/MiniMax-H3/resolve/main/loras/minimax_h3_fl2v_turbo_4step_v1.0_768p_comfyui_bf16.safetensors) · Turbo LoRA, 4 steps · `models/loras/` · 1.96 GB

## Workflows: Uses other MiniMax H3 models

These workflows load another MiniMax H3 model. Select taeh3_2d_kijai.safetensors in their Model Preview Override node to use it instead.

- [MiniMax H3 Long Video Generation | Motion Context V2](https://www.runcomfy.com/comfyui-workflows/minimax-h3-long-video-in-comfyui)
- [MiniMax H3 8-Step Acceleration | All-in-One Video Workflow](https://www.runcomfy.com/comfyui-workflows/minimax-h3-8-step-acceleration-all-in-one-comfyui-workflow)

## Same file, other names, and alternatives

- `taeh3_2d_kijai.safetensors` · This page · Kijai 2D, renamed · 9.8 MB · Light per-frame previews
- `taeh3.safetensors` · Different model · madebyollin temporal · 22.7 MB · Smooth motion previews; recommended

## Common errors and fixes

### Value not in list: tiny_vae: 'taeh3_2d_kijai.safetensors' not in [...]

Why: The workflow asks for this exact filename, but ComfyUI cannot find it in models/vae_approx. Usually the file is missing, sits in a different folder, or was saved under another name such as taeh3.safetensors (Kijai/MiniMax-H3-TAE).

Fix: Move the file into ComfyUI/models/vae_approx/, rename it to match the workflow (or pick it again in the dropdown), then refresh the node list or restart ComfyUI.

### Missing node type: ModelPreviewOverrideKJ

Why: Model Preview Override is not built into ComfyUI. It comes from the ComfyUI-KJNodes custom node pack.

Fix: Install ComfyUI-KJNodes with ComfyUI Manager (or git clone it into ComfyUI/custom_nodes), then restart ComfyUI.

### SafetensorError: Error while deserializing header

Why: The download is incomplete, or the browser saved an HTML sign-in or error page under the model’s filename.

Fix: Check that the file is exactly 9,791,388 bytes and that its SHA256 matches the value above. Download it again from Hugging Face · t8star/Taeh3-Comfy if not.

## FAQ

### Is this the same as taeh3.safetensors?

It is the same as the taeh3.safetensors in Kijai’s repo (SHA256 `f0f60fa072089997f817402098c2fd90777cb2660dd79cf5df42fc1e3e08e527`), but not the same as madebyollin’s taeh3.safetensors. Never overwrite one with the other.

### Where do I put taeh3_2d_kijai.safetensors in ComfyUI?

In `ComfyUI/models/vae_approx/`. Then refresh the node list or restart ComfyUI so Model Preview Override lists the file.

### Which ComfyUI node loads taeh3_2d_kijai.safetensors?

**Model Preview Override**. It comes from the [ComfyUI-KJNodes](https://github.com/kijai/ComfyUI-KJNodes) custom node pack, so install that first.

### Can I use taeh3_2d_kijai.safetensors commercially?

Yes. Kijai released it under Apache-2.0, which allows commercial use.

## Sources

- [Kijai/MiniMax-H3-TAE](https://huggingface.co/Kijai/MiniMax-H3-TAE)
- [t8star/Taeh3-Comfy](https://huggingface.co/t8star/Taeh3-Comfy)

Canonical page: https://www.runcomfy.com/comfyui-workflows/model-files/taeh3_2d_kijai.safetensors
