项目 · 项目报告

huangserva/ComfyUI_MiniMaxH3_Director

ComfyUI MiniMax H3 Director workflow

已完成 打开 GitHub
H
466星标
50Fork
0Issue
Apache-2.0许可证

分析结果

项目分析

这是一个面向 ComfyUI 的 MiniMax H3 Director 工作流集合仓库,提供 5 个可直接导入的 JSON 工作流,覆盖文生视频、图生视频、首尾帧生成、参考素材生成视频、视频编辑以及参考素材改视频等场景。仓库本身主要是工作流副本与使用说明,不包含核心节点实现和模型权重;实际运行依赖上游 AIMixer/ComfyUI_MiniMaxH3_Director 插件、MiniMax H3 模型权重以及较高规格的 NVIDIA GPU 环境。

适用领域 AI 视频生成 / ComfyUI 工作流 / 文生视频 / 图生视频 / 视频编辑 / 参考图/视频/音频驱动生成 / AIGC 内容制作 / 虚拟人/视频换人
配置难度 中高。对于熟悉 ComfyUI、自定义节点安装和模型文件管理的开发者,导入工作流较简单;但完整跑通需要下载大模型、配置 CUDA/PyTorch、处理显存限制,并理解不同模式下的输入素材、提示词和参数设置。对没有 ComfyUI 经验或没有高显存 GPU 的用户门槛较高。
商业价值 该仓库适合用于快速搭建和评估 MiniMax H3 视频生成/编辑能力,可帮助内容团队、AIGC 工具开发者和视频工作室验证文生视频、图生视频、参考素材生成、视频换人等流程。其商业价值主要在于缩短工作流搭建时间、提升模型测试效率,并为短视频广告、虚拟人内容、影视分镜预览、创意样片制作等场景提供可复现的 ComfyUI 基础模板。但正式商用前仍需解决模型授权、算力成本、人物一致性、质量稳定性和生产流程自动化等问题。
01

技术亮点

  • 提供 5 个现成 ComfyUI 工作流,导入即可测试,降低 MiniMax H3 Director 上手成本。
  • 覆盖 T2V、FL2V/I2V、R2V、V2V、RV2V 多种视频生成与编辑模式。
  • README 对模型文件路径、节点安装和运行注意事项说明较清楚。
  • 对 RV2V 视频换人场景给出具体操作流程,包括源视频切分、参考图/音频、逐段提示词和 5 秒预览测试。
  • 支持逐段运行和缓存,适合长视频分段编辑和局部修改。
  • 使用 Apache-2.0 许可,工作流层面的二次使用和集成相对友好。
  • 仓库星标数较高,说明在 ComfyUI/MiniMax H3 用户中有一定关注度。
02

目标用户

  • ComfyUI 用户
  • AI 视频创作者
  • AIGC 工作流开发者
  • 需要测试 MiniMax H3 Director 的研究者
  • 短视频、广告、影视预览制作团队
  • 希望复现 MiniMax H3 视频生成流程的开发者
  • 有高显存 NVIDIA GPU 的本地部署用户
03

配置要求

  • 推荐或已验证硬件为 NVIDIA RTX 4090 48GB,实际运行需要较高显存。
  • 需要 ComfyUI 0.30.0 或更高版本。
  • 已验证环境包含 PyTorch 2.11.0 + CUDA 12.8。
  • T2V、I2V、FL2V 模式需要 models/diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors。
  • R2V、V2V、RV2V 模式需要 models/diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors。
  • 共用文本编码器需要 models/text_encoders/qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors。
  • 共用视频 VAE 需要 models/vae/minimax_h3_video_vae_fp16.safetensors。
  • 共用音频 VAE 需要 models/vae/minimax_h3_audio_vae_fp32.safetensors。
  • CLIP Loader 类型需要选择 minimax。
  • 可选安装 SageAttention,并在 UNETLoader 与 MiniMaxH3Director 的 model 输入之间加入补丁节点以尝试加速。
04

适用场景

  • 通过提示词生成带音频的视频内容
  • 基于首帧或首尾帧生成视频片段
  • 使用图片、视频、音频作为参考素材生成新视频
  • 基于源视频时间轴进行逐段视频编辑
  • 结合源视频与人物参考图进行视频换人测试
  • 对同一素材进行固定 seed、分辨率、帧数、steps 的 A/B 测试
  • 快速导入 ComfyUI 进行 MiniMax H3 Director 工作流验证
  • 评估 Ref2VA、FL2VA 两类 MiniMax H3 权重在不同任务中的表现
05

部署与配置

  • 准备 ComfyUI 0.30.0 或更高版本环境。
  • 进入 ComfyUI/custom_nodes 目录。
  • 执行 git clone https://github.com/AIMixer/ComfyUI_MiniMaxH3_Director.git 安装上游导演台节点。
  • 执行 python -m pip install -r ComfyUI_MiniMaxH3_Director/requirements.txt 安装依赖。
  • 下载并放置 MiniMax H3 所需模型权重到 ComfyUI 对应 models 目录。
  • 重启 ComfyUI,确认 MiniMaxH3Director 节点已成功注册。
  • 将本仓库 example_workflows/ 目录中的 JSON 工作流拖入 ComfyUI 页面使用。
06

风险与注意事项

  • 仓库主要保存工作流副本,不包含核心插件代码和模型权重,必须依赖上游节点和 Hugging Face 模型。
  • 硬件门槛较高,已验证环境为 RTX 4090 48GB,普通消费级显卡可能显存不足或性能较差。
  • 当前 README 表示已验证环境只有 Ref2VA,可直接运行 R2V、V2V、RV2V;T2V、I2V、FL2V 需要额外补齐 fl2va 权重。
  • 人物身份一致性没有硬锁,视频换人或角色一致性场景需要人工检查和多次调参。
  • 段间引导不能替代人物一致性检查,长视频可能出现人物、服装、脸部或风格漂移。
  • 模型权重许可与工作流 Apache-2.0 许可不同,商业使用前需要单独核查 MiniMax H3 权重许可。
  • 依赖 ComfyUI、CUDA、PyTorch、上游自定义节点等多组件,版本不匹配可能导致节点无法加载或工作流报错。
  • SageAttention 等加速方案需要自行验证画质一致性,不能默认保证稳定收益。

历史记录

热榜历史快照

2026-08-11 第15名 新收录 · github_search
2026-08-10 第22名 新收录 · github_search
2026-08-09 第26名 新收录 · github_search