ComfyUI‑MMH3‑UltimateUpscale：单节点搞定显存受限显卡，放大MiniMax H3长时音视频

MiniMax H3 的 AV 潜空间比较特殊，视频24通道、音频32通道被打包在同一个张量内，ComfyUI原生放大节点无法识别这套嵌套结构，直接使用会破坏音频、极易爆显存，长时长、高分辨率视频放大更是难题。

Comfyui-MMH3-UltimateUpscale 是一个专为 MiniMax H3 模型设计的强大 ComfyUI 节点，旨在解决在消费级 GPU 上放大长时长、高分辨率视频时的显存瓶颈问题。

• GitHub：https://github.com/bbaudio-2025/Comfyui-MMH3-UltimateUpscale

Comfyui‑MMH3‑UltimateUpscale 把整套处理流水线封装为单个节点，依靠时间分块+空间平铺双机制，把峰值显存约束在单个平铺块大小，小显存显卡也能放大任意长度、任意分辨率的H3音视频，并且完整保留原始音频轨道，不对音频做重采样。

核心实现逻辑

H3视频放大完整链路：时间分割 → 潜空间放大 → 空间平铺分块 → 逐平铺采样 → 空间拼接 → 时间拼接，全部集成在主节点内部。
长视频切为带重叠的时间块，高分辨率帧切为空间平铺块；程序一次只采样一个平铺块，处理完成再做拼接混合。音频部分全程透传，不会参与扩散重采样，避免音频失真、杂音伪影。

主要功能特性

1. 显存可控，适配长视频与高分辨率
   时间分块适配任意视频时长，空间平铺适配任意输出分辨率；无论最终视频多长、分辨率多高，峰值显存仅等于单个平铺块，低配GPU也可以跑。
2. 两种潜空间放大路径可选

• 3D模型放大：调用latent_upscale_models目录下minimax_h3_latent_upscaler_3d_*.safetensors权重做H3专用潜空间放大。
• 无模型插值放大：nearest / bilinear / area / bicubic 插值调整潜空间尺寸，不需要额外模型，兼容H3嵌套AV张量结构。

3. 模块化可选阶段
   时间分块、潜空间放大、空间平铺三个参数模块均为可选，不接入对应参数节点即可跳过该环节，实现单块完整采样、不放大等多种组合。
4. 智能显存调度
   3D放大模型使用完毕自动卸载回CPU；放大器工作时H3主模型会卸载，避免两个大模型同时占用显存，下次采样自动重载H3。
5. 条件跟随分块处理
   提示词条件会按时间块重新锚定，空间平铺做条件裁剪；关键帧视频潜空间自动适配放大后的块网格尺寸。

如何解决拼接接缝问题

该节点重点解决分块带来的画面断层、闪烁、块接缝，分别从时间维度和空间维度做平滑处理。

时间一致性

• 第0帧锚点机制：除第一个片段外，每个时间块首帧，替换为上一块处理完成的边界帧，通过anchor_strength控制权重，消除时间块之间细节错位。
• 重叠块交叉淡入淡出：时间重叠区域使用线性淡入混合，块之间是平滑过渡，而非生硬硬切。

空间平铺一致性

• 冻结重叠掩码：平铺只采样内部自由区域，和相邻块的重叠条带使用已经拼接完成的结果做预填充锁定，采样不会修改接缝内容。
• 掩码写回机制：采样结束后，已经对齐的接缝区域强制写回，防止重采样覆盖掉已经正确的边缘。
• 可配置平铺混合策略：支持 linear / smoothstep / overwrite / midpoint 多种混合模式，也可设置前后块优先级，灵活控制平铺之间过渡效果。

全部节点说明

标准工作流

1. MiniMax H3生成AV混合潜空间（视频+音频一体）
2. 【可选】接入MMH3 Temporal Split Params时间分块参数
3. 【可选】接入放大模块：二选一，模型放大 / 插值放大
4. 【可选】接入MMH3 Spatial Split Params空间平铺参数
5. 将latent、条件、model、noise、sampler、sigmas输入主节点MMH3 Ultimate Upscale
6. H3 VAE解码输出潜空间得到成片

注意：放大设置的宽高，必须和条件对应的放大后生成尺寸保持匹配。

项目参考来源

节点基于两个社区已有项目二次开发：

• 时间/空间分割、锚定拼接逻辑：Comfyui‑MiniMax‑H3‑LatentSplit
• H3 3D潜空间放大器推理逻辑：Comfyui_Minimax_h3_latent_Upscaler