官方 ComfyUI 工作流设置

MiniMax H3 ComfyUI 工作流:
JSON 下载与设置教程

使用 MiniMax H3 的原生 ComfyUI 支持,构建统一的视频与立体声音频工作流。下面的按钮会从 Comfy-Org 加载当前官方文生视频(T2V)、图生视频(I2V)和参考生视频(R2V)模板。

下载官方工作流 所需模型文件 显存与硬件指南
01 / 官方模板

ComfyUI 工作流 JSON 文件

这些按钮会从 Comfy-Org workflow_templates 仓库加载官方 T2V、I2V 和 R2V 模板,确保下载的 JSON 与当前原生 ComfyUI 支持保持一致。

文生视频(T2V)

官方 MiniMax H3 文生视频 + 原生音频工作流

正在加载官方 Comfy-Org 模板……
图生视频(I2V)

官方 MiniMax H3 图生视频工作流

正在加载官方 Comfy-Org 模板……
参考生视频(R2V)

官方 MiniMax H3 参考生视频工作流

正在加载官方 Comfy-Org 模板……
02 / 所需模型文件

使用匹配的 ComfyUI 软件包

从官方 Comfy-Org/MiniMax-H3 仓库下载优化文件。T2V 和 I2V 使用 FL2VA 扩散模型;R2V 使用独立的 Ref2VA 扩散模型。请将这些 ComfyUI 文件与原始 BF16 H3-Base 检查点软件包分开。

FL2VA 扩散模型 / T2V + I2V

minimax_h3_fl2va_pruned_int8_convrot.safetensors
models/diffusion_models/

Ref2VA 扩散模型 / R2V

minimax_h3_ref2va_pruned_int8_convrot.safetensors
models/diffusion_models/

Qwen3-VL 文本编码器

qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
models/text_encoders/

视频 + 音频 VAE

minimax_h3_video_vae_fp16.safetensors
minimax_h3_audio_vae_fp32.safetensors
models/vae/

03 / 兼容性说明

ComfyUI 显存与分辨率指南

MiniMax H3 的显存需求取决于模型变体、精度、分辨率和卸载行为。官方 ComfyUI 文档没有定义统一的最低 GPU,因此请从原生模板设置开始。

主题 官方说明 实用起点 需要核对的内容
显存 没有公布统一的 H3 最低要求 从官方预览设置开始;遇到 OOM 时降低 Megapixels。 所选模型变体、精度和卸载行为
原生画布 短边 768px;16:9 约为 1344x768 预览时使用更低的 Megapixel 目标。 画面比例、时长和可用 GPU 显存
2K 输出 使用 H3-Regenerate-2K/API 工作流 不要把 2K 当作本地 ComfyUI 基准。 所选运行时是否提供重生成路径

01 / 使用原生 H3 支持

将 ComfyUI 更新到 0.30.0 或更高版本,然后打开 Template Library > Video > MiniMax H3。官方工作流不需要 H3 专用自定义节点。

02 / 放置模型文件

按照官方工作流提示,将文件放入 models/diffusion_modelsmodels/text_encoders, and models/vae.

03 / 加载官方 JSON

下载上方最新的官方 T2V、I2V 或 R2V 模板,并将其拖入 ComfyUI。模板包含原生节点连接和模型引用。

04 / 匹配参考标签

对于 R2V,请使用官方模板显示的精确标签引用输入,例如 <Picture 1><Video 1>, and <Audio 1>),然后为每个参考素材分配角色。

04 / 常见问题

常见问题

MiniMax H3 在 ComfyUI 中最低需要多少显存?

没有统一的官方最低值。要求取决于模型变体、精度、分辨率和卸载行为。请从官方预览设置开始;如果 ComfyUI 报告显存不足,则降低 Megapixel 目标。

如何修复 ComfyUI 中的 CUDA 显存不足(OOM)错误?

16GB 不是 H3 的统一最低值,也不是成功保证。降低工作流的 Megapixel 目标,使用官方模板推荐的模型变体,并按照当前 ComfyUI 内存管理说明调整,不要使用未记录的模型专用参数。

为什么找不到 MiniMaxH3ImageToVideo?

将 ComfyUI 更新到 0.30.0 或更高版本,并从 Template Library > Video 加载当前原生 H3 模板。官方工作流会提供所需的原生节点;节点名称缺失时不要用未经核验的自定义节点替代。

INT8 与 BF16 H3 文件有什么区别?

BF16 是原始 H3-Base 检查点路径,可与 SGLang 或 vLLM 等运行时配合使用。ComfyUI 软件包使用 INT8 扩散模型、NVFP4 文本编码器和独立 VAE。不要混用两种目录结构或检查点系列。

ComfyUI 模型文件放在哪里?

将扩散模型放入 models/diffusion_models/,将 Qwen3-VL 文本编码器放入 models/text_encoders/,将视频/音频 VAE 放入 models/vae/。文件名请与官方模板显示的名称完全一致。

必须使用 Sage Attention 吗?

Sage Attention 是 官方 ComfyUI H3 指南中的可选优化。请遵循指南当前的依赖和启动说明,在环境支持时使用 --use-sage-attention ;它不是验证基础工作流的必需项。

MiniMax H3 在 ComfyUI 中支持量化 GGUF 模型吗?

截至 2026 年 8 月,官方 H3 仓库没有列出 GGUF 发布版本。第三方 GGUF 节点不是官方组件;请使用原生 ComfyUI 模板引用的模型文件。

在哪里可以找到更多 MiniMax H3 工作流社区讨论?

请先查看官方 ComfyUI H3 指南 以及 Comfy-Org 工作流模板 ,再参考社区变体。