ComfyUI 从零到第一条 H3 带声视频 — MiniMax H3 教程
从空白 ComfyUI 环境出发，正确放置 5 个模型文件并生成一条画面、对白或环境声都能播放的 T2VA MP4。
适用人群: 第一次在 NVIDIA 电脑上本地运行 MiniMax H3、希望照着步骤完成而不是自己研究节点图的新手。
硬件要求: Windows 或 Linux + NVIDIA GPU；先准备充足磁盘空间。显存不足时先用模板预览尺寸，不要一开始就跑 1344×768。
前置条件
- 更新 NVIDIA 驱动；ComfyUI 需为 0.30.0 或更新版本
- Python 3.13；自定义节点兼容性有问题时退回 Python 3.12
- 能够访问 Hugging Face 上的 Comfy-Org/MiniMax-H3 模型文件
- 先准备一条短 Prompt：场景、主体动作、镜头、对白或环境声各写清楚
执行步骤
- 安装或更新 ComfyUI。Windows 可用官方 Desktop/Portable；Linux 或手动安装使用独立 Python 环境。启动后先确认页面能打开，控制台没有 CUDA 初始化错误。
- 打开 Template Library → Video → MiniMax H3 T2V。若弹出模型下载窗口，直接按提示下载；若手动下载，必须保持原文件名。
- 把 minimax_h3_fl2va_pruned_int8_convrot.safetensors 放进 ComfyUI/models/diffusion_models/。T2V 与 I2V 都用 FL2VA；只有 R2V 才换成 Ref2VA 权重。
- 把 qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors 放进 ComfyUI/models/text_encoders/；把 video VAE 和 audio VAE 一起放进 ComfyUI/models/vae/。缺少音频 VAE 时不能把静音结果当作成功。
- 把 minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors 放进 ComfyUI/models/loras/。它用于模板的可选 turbo_mode；第一次基线先关闭 Turbo，使用默认 20 步。
- 重启 ComfyUI 或刷新模型列表。逐个检查 Loader 下拉框能找到 diffusion model、text encoder、两个 VAE 与 LoRA；出现 null、undefined 或红色节点时先修路径，不要直接 Queue。
- 先用模板预览尺寸、16:9、multiple=32 和短时长生成。Prompt 先写完整场景，再写分镜/运镜，最后写对白、音效和音乐；先不要加自定义节点或多种加速器。
- 点击 Queue，等待 VAE 解码与视频封装完成。打开输出 MP4，分别检查画面、时长、声音和口型/事件同步，并保存这份工作流作为未修改的 baseline。
- 基线通过后再把分辨率提高到 H3 原生 1344×768，或在 Resolution Selector 选择 0.98 MP；不要选 1.0 MP，它会得到超过面积上限的 1376×768。
- 需要首尾帧时，在同一 FL2VA 工作流连接 first_frame/last_frame；需要人物、风格、动作或声音参考时，新建 R2V 模板并换成 Ref2VA 权重，不要在原图里混用两套模型。
命令
python --version
python -m pip install -r requirements.txt
python main.py
ComfyUI/models/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors
ComfyUI/models/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
ComfyUI/models/vae/minimax_h3_video_vae_fp16.safetensors
ComfyUI/models/vae/minimax_h3_audio_vae_fp32.safetensors
ComfyUI/models/loras/minimax_h3_fl2v_turbo_8step_v1.0_comfyui_bf16.safetensors
注意事项
- 模型文件很大；磁盘空间、下载中断和文件放错目录是最常见的首次失败原因。
- T2V/I2V 使用 FL2VA，R2V 使用 Ref2VA；权重混用会导致节点找不到模型或结果异常。
- H3 分辨率需为 32 的倍数；高分辨率和长时长会显著增加显存与等待时间。
- 官方模板和文件名会更新；执行前用参考资料复核当前版本，不照抄过期截图。
查看原始来源 · ComfyUI · 2026-08-23