Sanbot.MiniMax-H3-Image 是 MiniMax 11 月放出的文生图、改图一体模型，ComfyUI 在 v0.45.0 里加了原生支持，并配了两个官方模板。这篇照官方教程走一遍：升级、下载模型、打开模板出第一张图，再说怎么省显存。
数据来自官方和社区，未经本站实测。本文步骤和数字来自 ComfyUI 官方的 H3-Image 教程、ComfyUI v0.45.0 发布说明、ComfyUI 系统要求、启动参数说明和 H3-Image 模型卡，核实日期均为 2026-11-12（KST）。官方没有给出显存需求，文中凡是「多少显存能跑、要多久」的问题都写「待核实」。
开始前先确认三件事
- 协议的适用地区：MiniMax-H3-Image 社区许可的适用地区是「全球，但不含欧盟、英国、韩国和美国」，年化收入超过 100 万美元或者要做托管服务的，要先拿到 MiniMax 的书面授权。只转述原文，不下法律结论，以协议原文为准。两份协议的详细对比见 MiniMax-H3-Image 和 Qwen-Image 2.1 怎么选。
- 硬盘空间：官方模板要的 4 个文件合计约 55GB；不开提示词扩写的话可以不下扩写模型，约 47GB。
- 显存：官方没写最低显存。模板默认把画布开在 4MP，官方说明是为了让低显存的机器不爆显存，但没给具体数字。你的显卡能不能跑，待核实。
第一步：把 ComfyUI 升级到 0.45.0 以上
官方教程写明，两个模板都要求 ComfyUI 0.45.0 以上、模板包 0.11.104 以上。v0.45.0 的发布说明里有「Support MiniMax-H3-image」这一条，发布时间是 2026-11-11 06:42（KST），也是 2026-11-12 核实时 GitHub 上的最新正式版。v0.45.0 的依赖清单里，模板包版本是 0.11.105，满足要求。（2026-11-12 核实，发布说明、v0.45.0 依赖清单）
按你的安装方式升级（来源：官方更新指南）：
- 桌面版（Comfy Desktop）：打开管理面板的「Update」页更新。默认跟随正式版（Stable）通道。桌面版的正式版通道现在是否已经推到 0.45.0，待核实；更新后如果模板库里搜不到 H3-Image，说明版本还不够。
- Windows 便携版：运行便携版目录下
update文件夹里的update_comfyui_stable.bat（更新到最新正式版）。官方特别提醒，名字里带and_python_dependencies的那个脚本会重装依赖，可能引起冲突，日常更新不要用。 - 手动安装（git）：在 ComfyUI 目录里拉代码，再在 ComfyUI 自己的 Python 虚拟环境里更新依赖。官方提醒只
git pull不更新依赖是常见的出错原因。
cd ComfyUI
git pull
pip install -r requirements.txt
想确认模板包版本，可以在同一个环境里看一下：
pip show comfyui-workflow-templates
然后启动 ComfyUI：
python main.py
默认只监听本机，浏览器打开 http://127.0.0.1:8188 就是界面。（2026-11-12 核实，启动参数说明：默认监听地址 127.0.0.1、端口 8188）
第二步：下载 4 个模型文件
官方模板用的文件都来自 ComfyUI 官方（Comfy-Org）在 Hugging Face 上的仓库，按下表放进 ComfyUI/models 下对应的文件夹：
| 用途 | 文件 | 大小 | 放到 |
|---|---|---|---|
| 生成模型（精简版，INT8） | minimax_h3_image_pruned_int8_convrot.safetensors | 约 21GB | models/diffusion_models/ |
| 文本编码器（Qwen3-VL-32B，INT8） | qwen3vl_32b_minimax_h3_int8_convrot.safetensors | 约 25.28GB | models/text_encoders/ |
| 提示词扩写（Qwen3.5 9B，W4A8，可选） | qwen3.5_9b_w4a8_gptq.safetensors | 约 7.34GB | models/text_encoders/ |
| VAE（FP16） | minimax_h3_image_vae_fp16.safetensors | 约 1.17GB | models/vae/ |
（2026-11-12 核实，ComfyUI 官方教程）
也可以先打开模板再下载。官方说明：模板里内嵌了所需模型的链接，缺文件时，对应的加载节点会标红，右侧面板的「Errors」页会列出缺失的模型。桌面版点「Download」会直接存进对应文件夹；自己部署、用浏览器访问的，会触发浏览器下载，下完要自己放进对应文件夹。缺失检测只认对应文件夹顶层的同名文件。（2026-11-12 核实，模板说明）
H3-Image 的官方原版权重在魔搭上也有镜像（ModelScope），但那是原版 BF16 权重，不是上表的 ComfyUI 模板文件。魔搭上有没有这几个模板文件，待核实。
第三步：打开官方模板，出第一张图
在左侧栏点「Templates」（或者菜单「Workflow → Browse Workflow Templates」）打开模板库，搜：
- MiniMax-H3-Image: Text to Image：文生图。
- MiniMax-H3-Image: Image Edit：用一句话描述要改的地方来改图，最后会接一个改前改后的对比节点。
两个模板都用官方蒸馏好的采样设置，不要改：
| 设置 | 值 |
|---|---|
| 采样器 | euler |
| 调度器 | simple |
| 步数 | 6 |
| CFG | 1 |
| 降噪 | 1 |
CFG 是 1，所以模板没有负面提示词，想避免的内容也要写进正向提示词里。（2026-11-12 核实，ComfyUI 官方教程）
提示词扩写：模型卡说 H3-Image 最适合读「详细的英文整图描述」。模板里在采样前面放了一个扩写步骤，可以把短提示词改写成详细描述并挑画面比例。文生图模板默认关闭扩写，你输入什么就用什么；改图模板默认打开。官方的扩写模型是 Qwen3.8-27B 的 FP4 版（MiniMax-H3-Image-PE），模板为了能和 21GB 的生成模型放进同一张显卡，改用了更轻的 Qwen3.5 9B W4A8。（2026-11-12 核实，ComfyUI 官方教程、H3-Image 模型卡）
画布大小：模型原生出约 16MP 的图，各边按 32 像素的倍数生成。常用尺寸：
| 比例 | 尺寸（宽×高） |
|---|---|
| 1:1 | 4096×4096 |
| 4:3 / 3:4 | 4736×3552 / 3552×4736 |
| 3:2 / 2:3 | 5024×3360 / 3360×5024 |
| 16:9 / 9:16 | 5472×3072 / 3072×5472 |
| 21:9 | 6272×2688 |
文生图模板的分辨率选择器把比例和目标像素数分开设，默认 4MP 只是起点，不是上限。更小的画布也能用，出图更快。（2026-11-12 核实，ComfyUI 官方教程）
改图：最多 16 张参考图
改图模板把原图作为 <Picture 1> 送进模型。再加参考图时，按顺序就是 <Picture 2>、<Picture 3>……最多 16 张，提示词里用这些编号指代。第一张是要改的图，其余的提供道具、材质或构图。指令写短就行，官方举的例子是「把 <Picture 1> 里的车换成 <Picture 2> 里的那辆」。
加参考图的方法：在工作流里再放一个「Load Image」节点，同时连到提示词生成步骤和条件节点上。参考图不用预处理，模板会自动缩放到合适的尺寸。（2026-11-12 核实，ComfyUI 官方教程）
低显存设置
官方没给显存数字，下面只列官方明确写过的办法，效果待核实。
模板里能调的：
- 先用默认的 4MP 画布，显卡有余量再用分辨率选择器往上调。
- 改图爆显存：打开模板里的「Resize Image/Mask」节点，把图片的像素数调低再采样。
ComfyUI 启动参数（来源：启动参数说明）：
官方写明，在 NVIDIA 和 AMD 显卡上，异步权重卸载默认开启；动态显存在支持的系统上自动开启（NVIDIA 默认开，AMD 要 ROCm 7.14 以上）。所以多数情况下不用加参数。下面几个参数会覆盖默认行为：
| 参数 | 官方说明 |
|---|---|
--lowvram |
动态显存开启时不起作用；否则把文本编码器放到 CPU 上跑 |
--novram |
--lowvram 还不够时，尽量少用显存 |
--reserve-vram 数字 |
给系统和其他软件预留多少 GB 显存 |
--disable-smart-memory |
更积极地把模型卸载到内存，而不是留在显存里 |
每个参数的完整说明见 ComfyUI 官方文档启动参数说明的「VRAM & Memory」一节；H3-Image 适用哪个参数待核实。
ComfyUI 的 README 称，靠异步权重流式加载，最大的开源模型也能在 4GB 显存加 8GB 内存上跑得比较快。但这是 ComfyUI 的总体说法，没有针对 H3-Image 的数字，H3-Image 在小显存加小内存的机器上能不能跑、多慢，待核实。（2026-11-12 核实，ComfyUI README）
更小的模型文件：ComfyUI 官方的 H3-Image 仓库里还有 W4A8 生成模型（约 12.55GB）和 NVFP4 文本编码器（约 15.69GB），但官方教程没写怎么替换，画质和显存占用待核实。（2026-11-12 核实，Comfy-Org/MiniMax-H3-Image）
出问题先查这几项
- 模板库里搜不到 H3-Image：官方说明，模板里找不到通常是 ComfyUI 版本太旧。按第一步升级到 0.45.0 以上。
- 加载工作流时提示缺节点：官方列的原因有两个，一是不是最新版，二是有节点在启动时导入失败。看启动日志里有没有报错。
- 加载节点标红：缺模型文件，或者文件没放在对应文件夹的顶层，见第二步。
- 改图时爆显存：按上一节打开「Resize Image/Mask」节点，调低像素数。
（2026-11-12 核实，ComfyUI 官方教程、模板说明）
小结
- 版本：ComfyUI 0.45.0 以上、模板包 0.11.104 以上；手动安装的，
git pull之后记得更新依赖。 - 文件：4 个，合计约 55GB；不开扩写可以少下 7.34GB。
- 模板：6 步、CFG 1、不用负面提示词；文生图默认 4MP 画布，改图最多 16 张参考图。
- 省显存：先用小画布，改图时打开缩放节点，再看启动参数；官方没给显存数字，各档显卡能不能跑待核实。
- 协议：适用地区不含欧盟、英国、韩国、美国，以协议原文为准。
站内推荐
- 和 Qwen-Image 2.1 比参数、体积和协议：MiniMax-H3-Image 和 Qwen-Image 2.1 怎么选：本地生图改图按显卡看
- 让 H3-Image 工作流更好维护：让 ComfyUI 工作流更好维护的 5 个习惯
- 本地改图方案按显卡分档：本地生图生视频 · 可编辑生图
- 不想摆弄节点，看看其他本地工具：WanGP 和 ComfyUI、SwarmUI、FreeVideo 怎么选：本地生图生视频工具横评
- 更多 ComfyUI 教程：ComfyUI 教程