它能帮你做什么#

这是一套面向 Windows 和 NVIDIA 显卡的 MiniMax H3 本地 ComfyUI 环境，主要用于图生视频（I2V）和参考图生视频（R2V）。

与旧版“一体包”不同，本次把长期不需要频繁更新的大模型，与会持续更新的 ComfyUI、Python 和自定义节点拆成两个独立部分。以后模型没有变化时，只需要更新体积较小的 ComfyUI 环境镜像包，不必重复下载约 59.73 GiB 的模型。

本资源更适合已经了解 ComfyUI 基本操作、具备 NVIDIA RTX 显卡，并愿意根据自己的显存、系统内存和输入素材继续测试的人。

需要下载的两个部分#

1. MiniMax H3 模型包#

  • 网盘名称：MiniMax_H3_模型包_v1
  • 提供形式：百度网盘文件夹，不额外压缩
  • 总体积：约 59.73 GiB
  • 权重数量：6 个
  • 包含两个 H3 diffusion model、一个 Qwen3-VL 文本编码器、Audio VAE、Video VAE，以及 H3 Latent 3D 放大模型
  • 附带模型来源、许可证、NOTICE 和 SHA256SUMS.txt

请下载完整的 MiniMax_H3_模型包_v1 文件夹，不要只下载其中几个模型文件，也不要打乱 models 下的目录结构。

2. MiniMax ComfyUI Sage 环境镜像包#

  • 压缩包：MiniMax_ComfyUI_sage_便携包_20260904.zip
  • 网盘显示体积：约 6.4 GiB
  • 包含便携版 Python、ComfyUI、完整 custom_nodes、对应 Python 依赖、FFmpeg、I2V/R2V 工作流、Windows H3 SageAttention 和启动脚本
  • 不包含 H3 模型、5.png、个人输入素材、输出结果、旧日志或个人用户配置

正确的放置结构#

下载并解压便携包后，两个文件夹必须位于同一级目录，并保留原目录名：

TEXT
同一个父目录/
├─ MiniMax_H3_模型包_v1/
│  └─ models/
│     ├─ diffusion_models/
│     ├─ latent_upscale_models/
│     ├─ text_encoders/
│     └─ vae/
└─ MiniMax_ComfyUI_sage_便携包_20260904/
   ├─ ComfyUI/
   ├─ python_embeded/
   ├─ update/
   └─ 启动_MiniMax_H3.bat

便携包通过 ComfyUI/extra_model_paths.yaml 读取旁边的模型包。接收者不需要把模型复制进 ComfyUI，不需要管理员权限，也不需要自己创建软链接。

检查与启动#

双击下面的文件启动：

TEXT
MiniMax_ComfyUI_sage_便携包_20260904\启动_MiniMax_H3.bat

如果只想检查运行环境、关键节点和 6 个外部模型是否齐全，可以在命令提示符中进入便携包目录后执行：

BAT
启动_MiniMax_H3.bat --check-only

看到以下提示，表示启动所需的关键文件和模型已经找到：

TEXT
[OK] MiniMax H3 mirror package preflight passed.

正常启动后，在浏览器打开：

TEXT
http://127.0.0.1:8188

随包工作流位于：

TEXT
ComfyUI/user/default/workflows/minimax_h3/

其中包含：

  • video_minimax_h3_i2v.json
  • video_minimax_h3_r2v.json

执行前必须把工作流中不存在的示例图片替换为自己的输入素材，并根据实际任务修改提示词和参数。

Windows H3 SageAttention#

2026-09-04 环境镜像已加入适配当前 H3 节点交接方式的 Windows SageAttention：

  • sageattention 2.2.0 Python 3.10 Windows 原生扩展
  • RTX 4090（SM89）原生 kernel
  • H3 所需的 sageattn_consume() 容器交接接口
  • cloned-V 判定与长序列 int64 偏移保护
  • MiniMaxH3SageAttention 节点已通过 ComfyUI /object_info 注册检查
  • H3 NHD 布局、GPU smoke 和 peek/take 容器交接已在 RTX 4090 上通过

原 I2V/R2V 工作流文件没有被自动改写。启动器仍以 PyTorch SDPA 作为默认注意力实现；只有在工作流中显式使用 MiniMax H3 SageAttention 节点时才会启用 SageAttention。详细说明见便携包根目录的 SageAttention使用说明.md。

SageAttention 实测范围#

本版本不是只把节点放进目录。发布者已在 RTX 4090 上完成一轮固定条件 A/B：864×480、362 帧 / 15.083 秒、20 steps、simple、同一 Seed 2026090308；唯一区别是在 Sage 组接入 MiniMaxH3SageAttention(auto, head_chunks=1, patch_token_refiner=false)。

项目原始 SDPASage auto
SamplerCustomAdvanced763.309 秒471.411 秒
每步平均（20 步）38.17 秒23.57 秒
采样加速—1.62×
采样耗时下降—38.2%
全工作流约 12 分 55 秒8 分 02 秒

日志确认 Sage 组实际 patch 了 50 个 H3 attention 模块；VAE 解码约 44.5 秒与 43.7 秒，几乎没有差异，因此本次收益明确来自采样阶段。注意力数值路径发生变化后，仍建议先用自己的常用提示词与素材人工检查画质、动作和稳定性；该 A/B 不能直接代表所有显卡、驱动、分辨率或工作流。

当前环境版本#

  • 发布目录版本：2026-09-04
  • Python：3.10.19
  • PyTorch：2.11.0+cu130
  • CUDA runtime：13.0
  • ComfyUI commit：71391e88c01aa1e44711678e7d1b8f408e280338
  • 自定义节点：镜像构建时完整同步自发布者当前实际运行的 custom_nodes
  • H3 SageAttention 节点 commit：c91171881756620b217b066770cac27dbbf6378d
  • SageAttention：2.2.0（Windows / Python 3.10 / RTX 4090 SM89 原生 kernel）
  • 本地修改：包含 execution.py 的 H3 节点计时功能
  • 本地组件：包含 ComfyUI/ffmpeg

启动器根据发布者实际使用的 CUDA 13 稳定启动脚本改造，保留端口检查、ComfyUI Manager、PyTorch SDPA、Dynamic VRAM、Pinned Memory、关闭预览和节点缓存、预留 1.5 GB 显存、运行日志与 H3 节点计时日志。

分享版没有固定 RTX 4090 的 CUDA 架构参数，由 PyTorch 和相关节点根据接收电脑的 NVIDIA GPU 判断，避免把启动器锁定在单一显卡型号。

使用环境#

  • 操作系统：Windows x64
  • 显卡：现代 NVIDIA RTX 显卡；本机验证环境为 RTX 4090 24GB
  • 驱动：需要能够运行 CUDA 13 版 PyTorch 的较新 NVIDIA 驱动
  • 内存：MiniMax H3 对系统内存和页面文件要求较高
  • 磁盘：同时保留模型包、ZIP 和解压后的便携包时，建议准备至少 80 GiB 可用空间

软件文件相同不代表不同显卡拥有相同速度、显存占用或可用分辨率。RTX 4090 的验证结果不能直接代表其他显卡。

已验证范围#

本次整理已经检查：

  • 便携环境镜像文件
  • 外部模型读取路径
  • 6 个模型文件识别
  • MiniMax H3 关键节点导入
  • Windows H3 SageAttention 原生 GPU 快速验证
  • H3 NHD 布局与 peek/take 容器交接
  • RTX 4090 下固定条件的 MiniMax H3 视频 A/B：Sage 组实际 patch 50 个 attention 模块，采样器 763.309 秒降至 471.411 秒
  • CPU 快速启动检查
  • 本机 NVIDIA CUDA 快速启动检查
  • ComfyUI 服务启动和节点接口读取

本次没有在打包后的副本中重新执行一轮完整 MiniMax H3 视频生成。接收者的显卡、驱动、系统内存、页面文件和外部软件仍可能导致运行差异。

更新方式#

模型没有变化时，只需要下载新版 ComfyUI 环境镜像包。建议把新版解压到新目录并先完成检查，不要直接覆盖包含个人工作流、输入或输出的旧目录。

模型包只有在模型版本或权重数量变化时才需要重新下载。不要把模型重新复制进每一个 ComfyUI 版本，否则会重复占用大量磁盘空间。

模型来源与许可证提醒#

MiniMax H3、Qwen3-VL、H3 Latent 3D 放大模型和第三方节点分别受各自许可证约束。模型包内已经保留对应许可证、NOTICE、来源说明和 SHA-256 清单。

MiniMax H3 Community License 当前包含地域和再分发条件。下载、使用和再次分享前，请自行核对适用范围、完整协议与 Acceptable Use Policy。本页说明不构成法律意见。

当前领取状态#

本资源稿已按 2026-09-04 的 Sage 便携版更新。百度网盘目录保留独立模型包和新版 Sage 便携包；模型包无需重复下载，已使用旧环境镜像的用户只需下载并解压新版环境包，再按“正确的放置结构”与模型包并列放置。

更新记录#

  • 2026-09-04：更新为 MiniMax_ComfyUI_sage_便携包_20260904.zip；加入 Windows H3 SageAttention、H3 专用节点和 RTX 4090 SM89 原生 kernel。固定条件 A/B 确认实际 patch 50 个 H3 attention 模块，采样器从 763.309 秒降至 471.411 秒（约 1.62×）；原 I2V/R2V 工作流及独立模型包保持不变。
  • 2026-09-03：停止提供旧的一体包，调整为独立模型包与 ComfyUI 当前环境镜像包；模型数量由 5 个更新为 6 个，并加入 H3 Latent 3D 放大模型。
  • 2026-08-20：首次发布 MiniMax H3 ComfyUI 一体便携包。