ComfyUI MiniMax H3 Director 工作流部署教程。该项目为ComfyUI提供了一套可直接导入的视频生成工作流，支持文生视频、图生视频、视频编辑和视频换人等多种功能。

本教程将引导你完成从环境准备、插件安装到模型下载和首次运行的全过程。

📥 第一步：环境与依赖准备

在开始之前，请确保你的ComfyUI环境满足以下要求，这是成功运行的基础。

  • ComfyUI版本：需要 0.30.0 或更高版本。建议使用最新版以获得最佳兼容性。
  • 硬件要求：项目已在 NVIDIA RTX 4090 48GB 显卡上验证。请确保你的GPU有足够的显存（至少16GB以上推荐），并已正确安装 CUDA 12.8 及对应的PyTorch（项目验证环境为 PyTorch 2.11.0 + CUDA 12.8）。

🔌 第二步：安装核心插件

你需要安装上游的导演台节点插件，这是运行这些工作流的“引擎”。

  1. 进入ComfyUI的 custom_nodes 目录：

    1
    cd ComfyUI/custom_nodes

  2. 克隆上游插件仓库：

    1
    git clone https://github.com/AIMixer/ComfyUI_MiniMaxH3_Director.git

  3. 安装插件依赖：

    1
    pip install -r ComfyUI_MiniMaxH3_Director/requirements.txt

  4. 重启ComfyUI，确保插件被正确加载。

📂 第三步：下载并放置模型文件

这是最关键的一步。你需要根据要运行的工作流类型（T2V/I2V/FL2V 或 R2V/V2V/RV2V），下载对应的模型权重并放置在正确的目录下。

模型文件总览与存放路径：

模型文件 用途 存放路径 (相对于ComfyUI根目录)
minimax_h3_fl2va_pruned_int8_convrot.safetensors T2V, I2V, FL2V 工作流需要 models/diffusion_models/
minimax_h3_ref2va_pruned_int8_convrot.safetensors R2V, V2V, RV2V 工作流需要 models/diffusion_models/
qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors 共用文本编码器 models/text_encoders/
minimax_h3_video_vae_fp16.safetensors 共用视频VAE models/vae/
minimax_h3_audio_vae_fp32.safetensors 共用音频VAE models/vae/

下载方式：

  • 官方推荐：从 Comfy-Org/MiniMax-H3 在Hugging Face上的仓库下载，或使用ComfyUI Manager进行下载。
  • 注意：当前已验证环境只有 ref2va 权重，可稳定运行R2V、V2V、RV2V工作流。fl2va 权重需要自行补齐才能运行T2V等。

🚀 第四步：导入并运行工作流

  1. 将从本仓库 example_workflows/ 目录下载的 JSON 工作流文件（如 minimax_h3_director_t2v.json）直接拖入ComfyUI的浏览器界面。
  2. 工作流加载后，检查所有节点，特别是 CLIP Loader 节点，确保其类型选择了 minimax。
  3. 根据你的需求，在工作流节点中上传源视频、参考图或参考音频，并编写提示词。
  4. 点击 “Queue Prompt” 按钮开始生成。

💡 高级功能与使用提示

  • 视频换人 (RV2V) 工作流：
    1. 导入 minimax_h3_director_rv2v.json 工作流。
    2. 上传源视频（建议按镜头切分），上传人物参考图（需要声音约束时再加参考音频）。
    3. 为每段视频编写提示词，源片段使用 <Video 1> 绑定，参考素材使用 <Picture N>、<Audio J>。
    4. 先生成5秒短片，检查效果后再决定是否扩展时长。
  • 分段编辑与缓存：导演台支持逐段选择运行和缓存，修改一段时不需要重跑整个时间轴，非常高效。
  • 性能优化（可选）：可以尝试安装 SageAttention 库来加速注意力计算。将补丁节点放置在UNETLoader与MiniMaxH3Director节点的 model 输入之间即可启用。
  • A/B测试：固定源素材、提示词、随机种子(seed)、分辨率、帧数和steps等参数，可以方便地进行效果对比测试。

⚠️ 注意事项

  • 模型文件：确保所有模型文件已完整下载并放置在正确的路径，否则节点会报错。
  • 显存管理：视频生成非常消耗显存。如果遇到内存不足错误，可以尝试降低生成视频的分辨率或帧数。
  • 一致性：人物身份由模型和参考素材共同约束，导演台没有“硬身份锁”。如果需要高度一致的角色，可能需要结合其他工具或手动调整。
  • 许可协议：工作流遵循Apache-2.0许可，但模型权重遵循其各自的许可条款，请注意区分。

如果在部署中遇到问题，可以查阅上游插件 AIMixer/ComfyUI_MiniMaxH3_Director 的文档或在相关社区提问。希望这份指南能帮你在ComfyUI中顺利使用MiniMax H3 Director工作流。