Nodes/comfyui-minimax-h3-audio-T8/MiniMax H3 Chunked Two-Pass Plan (Advanced EXP/T8)
ComfyUI Node

MiniMax H3 Chunked Two-Pass Plan (Advanced EXP/T8)

The planner for H3's chunked two-pass upscale — and why full-frame is the safe default

By T8mars·Created 2 months ago·Updated about 8 hours ago· 1,158
MiniMax H3 Chunked Two-Pass Plan (Advanced EXP/T8)
  • source_latent
  • plan
  • report_json
  • width
  • height
◄model_name▾►
◄target_width1280►
◄target_height704►
◄temporal_chunk_frames136►
◄temporal_overlap_frames17►
◄anchor_strength0.999►
◄tile_width512►
◄tile_height512►
◄spatial_overlap128►
◄spatial_fade32►
◄minimum_tile_size256►
◄overlap_blendsmoothstep►
◄precisionfp16►
◄release_policyoffload_after►
◄spatial_strategyfull_frame_safe►
◄sampling_contractvideo_only_legacy►
◄parity_report_json—►
◄size_modetarget_dimensions►
◄scale_by2.00►
◄target_megapixels0.70►
◄aspect_policypreserve_source►
◄max_anisotropy1.05►

The classic two-pass recipe from image generation - render small, upscale, re-sample at low denoise - has a video-shaped problem: your "image" is a joint audio-video latent that gets very long, very fast. This node is the planning half of the T8 pack's chunked two-pass answer for MiniMax H3. It produces a plan describing how a learned 3D latent upscale and a temporal-chunk H3 re-sample should run. The other half, MiniMaxH3ChunkedTwoPassUpscaleT8Advanced, executes it.

The idea is straightforward and worth knowing before you touch any slider: first pass generates a low-resolution H3 clip, then an independent learned 3D upscaler model grows the latent (not the pixels) to high resolution, and then H3 re-samples at the higher canvas to add real detail. That's different from plain interpolation, and the KB's upscaling notes back the intuition: upscaling the intermediate and doing a low-denoise second pass is the standing recipe for coherent high-res output. The "learned" part is the difference between this and the pack's simple 32-divisible latent upscale - a model trained to add plausible detail instead of just resizing.

The inputs that matter

There are a lot of sliders here, but the safe defaults are actually safe. The ones you'll touch:

  • model_name - the learned 3D latent upscaler from ComfyUI/models/latent_upscale_models (the pack expects minimax_h3_latent_upscaler_3d_fp16.safetensors).
  • target_width / target_height - default 1280×704. The note in the description is worth reading: there is no project pixel-area ceiling; memory and runtime are yours to own. 1920×1088 is a risk reference area, not a hard limit, and bigger will warn but not block.
  • temporal_chunk_frames (136) and temporal_overlap_frames (17) - the clip is split into temporal chunks so the whole thing fits in memory. The overlap lets chunks blend into each other rather than showing seams.
  • anchor_strength (0.999) - how strongly each chunk is anchored to the previous one's result. This is your seam-control knob.
  • spatial_strategy - the one that decides everything about risk. full_frame_safe keeps each temporal chunk full-frame, which preserves H3's global spatial context. independent_tiles_exp splits the frame into independent spatial canvases to save memory, and the "exp" suffix is doing real work: those tiles' content can diverge, so it's research-only.

Tiles, overlaps, fades, blend mode, precision and release policy round out the plan - leave them alone until you know why you're changing them. Outputs are the plan object (feed it to the Upscale executor) and a report_json describing what you're about to do.

Who it's for

If you're generating H3 at 1472×832 or bigger on a 16GB card and hitting OOM, this is the workflow's planning stage. It pairs naturally with the pack's 13-latent-upscale workflows, which use a low-res 4-step pass + learned upscale + high-res pass. And keep the pack's honesty rule in mind: chunked two-pass doesn't mean "unlimited resolution is now free." It lowers the peak memory by chunking the temporal dimension; it doesn't lift the per-chunk cost.

Install

Same pack, same steps:

cd ComfyUI/custom_nodes
git clone https://github.com/T8mars/comfyui-minimax-h3-audio-T8.git minimax-h3-audio-T8

or ComfyUI Manager → "MiniMax H3 Audio T8" → restart. Update ComfyUI itself first. The one model you do need for this node is the learned 3D latent upscaler - grab it from the pack's model links or the t8star HuggingFace org and drop it in ComfyUI/models/latent_upscale_models.

CategoryT8/MiniMax H3/Upscale/Advanced

Inputs (23)

NameTypeDefaultDescription
model_nameCOMBO1 options: minimax_h3_latent_upscaler_3d_fp16.safetensors
target_widthINT128032–16384仅target_dimensions模式使用。倍率/面积模式忽略此值;请用width输出连接HIGH条件。连接source_latent时会按aspect_policy计算实际目标尺寸。
target_heightINT70432–16384仅target_dimensions模式使用。倍率/面积模式忽略此值;请用height输出连接HIGH条件。实际输出为32像素对齐后的尺寸。
temporal_chunk_framesINT13617–3600—
temporal_overlap_framesINT170–1700—
anchor_strengthFLOAT0.9990–1—
tile_widthINT51232–16384—
tile_heightINT51232–16384—
spatial_overlapINT1280–4096—
spatial_fadeINT320–4096—
minimum_tile_sizeINT25632–4096—
overlap_blendCOMBOsmoothstep2 options: smoothstep, linear
precisionCOMBOfp163 options: fp16, bf16, fp32
release_policyCOMBOoffload_after3 options: offload_after, clear_after, keep_loaded
spatial_strategyCOMBOfull_frame_safe2 options: full_frame_safe, independent_tiles_exp
sampling_contractoptCOMBOvideo_only_legacy旧默认只重采视频并保留输入音频。标准4+4选standard_joint_4plus4_exp,并连接Parity Plan的report_json;每窗后4步联合AV,交付二采音频。
parity_report_jsonoptSTRING标准4+4模式必接Learned Two-Pass Parity Plan的report_json;旧模式不需要。
size_modeoptCOMBOtarget_dimensions旧默认手填尺寸;scale_by按源LATENT倍率、target_megapixels按目标面积计算,均使用普通放大节点的数学与32像素对齐规则。
scale_byoptFLOAT2.001–4scale_by模式生效,例如1.5或2.0。必接source_latent,target_width/height在倍率模式不参与计算。
target_megapixelsoptFLOAT0.700.01–8—
aspect_policyoptCOMBOpreserve_source连接源LATENT时preserve_source保持原比例;honor_dimensions_exp允许按手填尺寸改变比例,仍检查max_anisotropy。旧图不接源时仍保留原手填尺寸。
max_anisotropyoptFLOAT1.051–2—
source_latentoptLATENT接一采LATENT(标准4+4用denoised_output),用于读取实际原始宽高;不是HIGH条件的LATENT,不改变输入视频或音频。

Outputs (4)

NameTypeDescription
planT8_H3_CHUNKED_TWO_PASS_PLAN—
report_jsonSTRING—
widthINT—
heightINT—