最后更新 2026-11-13
EN 简体 繁體

MiniMax H3-Image 本地部署:135GB 与 ComfyUI

ModelBrief · 2026-11-13 发布 · 事实核查 2026-11-13 · 参考来源:ComfyUI 官方博客

H3-Image 的权重公开,本地部署是官方支持的正经路径——但「下载 68.65GB 就能跑」是个误解。首次部署实际要下载约 135GB,分属两个仓库;框架有五种,官方推荐 SGLang;ComfyUI 在发布当天就给了原生支持。最大的缺口是:官方至今没公布 VRAM 需求。

文件清单:约 135GB,分两个仓库

组件来源仓库体积
DiT TransformerMiniMax-H3-Image66.28GB
VAEMiniMax-H3-Image2.34GB
逐层输出头 + 分词器MiniMax-H3-Image约 35MB
文本编码器(Qwen3-VL)MiniMax-H366.7GB
合计—约 135GB
PE 提示扩展(可选)MiniMax-H3-Image-PE17.9GB

文本编码器不在 H3-Image 仓库里,必须从 MiniMax-H3 仓库另行下载——这是最容易漏的一步。已经本地部署 H3 的用户不用重复下载,编码器完全相同。另注意 techtoheart 称本地包约 127GB 磁盘占用,与 135GB 有出入(可能为压缩后或不同统计口径),以官方文件体积为准。PE 是可选的提示扩展模型(17.9GB NVFP4,由 Qwen3.8-27B 微调),用于本地复现 API 的提示扩展,不用它也能跑模型。

框架选择:SGLang 是官方推荐

模型卡推荐 SGLang 作为参考路径,附 cookbook 与单 GPU 命令,支持 --ulysses-degree 序列并行。vLLM-Omni 提供 H200、RTX PRO 6000 Blackwell、MI350X 三种硬件的配方,但首日配方只练到每请求 9 张参考图——16 张是模型上限,9 张是该框架配方实测值。此外还有 diffusers 与 LightX2V。GitHub 上有 MiniMax-AI/MiniMax-H3-Image 官方仓库,ModelScope 也有镜像。

选框架的实际建议:想最快跑起来、跟着官方 cookbook 走,用 SGLang;已有 vLLM-Omni 环境、用 H200 或 Blackwell 卡,用 vLLM-Omni;想在图形界面里拖节点,用 ComfyUI(见下节)。diffusers 适合想自己写推理代码的人。

ComfyUI:首日原生支持,两种用法

ComfyUI 博客在 11 月 10 日 16:05 UTC 宣布原生支持,v0.45.0 同日上线,含 H3-Image 节点与文生图、编辑两套官方工作流模板。文生图与编辑共用同一张图:接上参考图就切换到编辑模式。两种用法:下载权重在自己 GPU 上跑,或走 Partner Nodes 用 MiniMax API(不下载权重)。与 H3 共享 Qwen3-VL 文本编码器,已有 H3 者无需重复下载。

Partner Nodes 是个值得注意的中间路线:不用下载 135GB,也不用自己配 GPU,就能在 ComfyUI 界面里调用官方 API。代价是按 API 计费,且提示扩展等行为走 API 侧——适合想先试效果、再决定是否本地部署的人。

缺失的 VRAM 指引

官方只给文件体积,未给任何显存指引:单卡能不能跑、要多少显存、量化方案有没有,全部没有说法。文件体积不等于 VRAM 需求——推理时除了权重还要放 KV 缓存、激活与中间结果,6 步采样虽然步数少,但 4K 生成的潜变量本身就大。不要按 135GB 推算显卡,也不要按 68.65GB 推算。第三方蒸馏版 P-H3-Image 有 4-bit 约 21GB 的路径,但那是另一个模型,不适用于官方 H3-Image。本站会在官方或社区给出可信的 VRAM 数据后更新。

部署前先读许可

权重许可排除美国、欧盟、英国、韩国——这些地区的人用权重须先联系 MiniMax 另行取得许可;年收入超 100 万美元或提供托管服务须书面授权;商用界面须展示模型名;输出不得用于训练其它模型。下载前请读 LICENSE 全文,详见本站许可证详解。

参考来源:ComfyUI 博客 — MiniMax H3 Image is now available in ComfyUI(本站改写整理,事实以官方来源为准)