How lbh-123-ai/comfyui_minimax_h3_latent_upscaler works
This repository is a ComfyUI custom-node package for upscaling Minimax H3 video latents. Users either apply a learned 2D or 3D upscaler to latent video, or use the separate split-upscale combo to re-sample AV latents in temporal chunks and spatial tiles. The 3D variant supports multiplier, target-dimension, and megapixel sizing; the combo provides split-parameter nodes and seam/color/temporal consistency handling. The graph reflects documented capabilities, but sampled excerpts are partial, so internal wiring beyond explicit registration and the shown split-upscale flow is omitted.
Main entry points: MMH3_Split_Upscale.py Split upscale · __init__.py Node registry · minimax_h3_latent_upscaler_2d.py 2D latent node · minimax_h3_latent_upscaler_3d.py 3D latent node
Components 14
Node registration
- Package exports
__init__.py - Node registry
nodes/__init__.py
Learned upscalers
- 2D latent node
nodes/minimax_h3_latent_upscaler_2d.py - 2D resizer
nodes/minimax_h3_latent_upscaler_2d.py - 3D latent node
nodes/minimax_h3_latent_upscaler_3d.py - 3D resizer
nodes/minimax_h3_latent_upscaler_3d.py - Upscaler weights
nodes/minimax_h3_latent_upscaler_3d.py
Split resampling
- Temporal params
nodes/MMH3_Split_Upscale.py - Spatial params
nodes/MMH3_Split_Upscale.py - Split upscale
nodes/MMH3_Split_Upscale.py
Other components
- ComfyUI user
- ComfyUI sampler
- H3 AV latent
- Upscaled latent
Connections 22
- ComfyUI user → Package exports: loads nodes
- Package exports → Node registry: exports mappings
- Node registry → 2D latent node: registers
- Node registry → 3D latent node: registers
- Node registry → Split upscale: registers
- ComfyUI user → 2D latent node: provides latent
- 2D latent node → 2D resizer: runs inference
- Upscaler weights → 2D resizer: loads weights
- 2D resizer → Upscaled latent: returns latent
- ComfyUI user → 3D latent node: provides latent
- 3D latent node → 3D resizer: runs inference
- Upscaler weights → 3D resizer: loads weights
- 3D resizer → Upscaled latent: returns latent
- ComfyUI user → Temporal params: configures chunks
- ComfyUI user → Spatial params: configures tiles
- Temporal params → Split upscale: split settings
- Spatial params → Split upscale: tile settings
- ComfyUI user → Split upscale: provides AV latent
- H3 AV latent → Split upscale: input latent
- ComfyUI sampler → Split upscale: sampling inputs
- Split upscale → ComfyUI sampler: dispatches sampling
- Split upscale → Upscaled latent: stitches latent