MiniMax H3 + ComfyUI 一体镜像

基于 ComfyUI 0.30.0，预装 MiniMax H3 音视频联合生成全套环境，开机即用，内置 T2VA / R2V 官方与第三方节点，适合文生视频、参考图生视频等场景，输出带同步音频的 MP4。

镜像作者：Clare

b站（教程搜索minimax H3）：https://space.bilibili.com/383142397?spm_id_from=333.1007.0.0

环境信息

• ComfyUI 版本：0.30.0（commit a464ac335 基线）

• Python：3.10.15

• PyTorch：2.8.0+cu128

• 已装 ffmpeg：VideoHelperSuite 依赖，用于合成音视频 MP4

已安装的自定义节点

插件	来源	说明
minimax-h3-audio-T8	T8mars/comfyui-minimax-h3-audio-T8	独立 T8 节点扩展，注册 14 个节点，覆盖音画联合条件、双时钟采样、AV 解码等，无额外 pip 依赖
ComfyUI-VideoHelperSuite	Kosinkadink/ComfyUI-VideoHelperSuite	视频/音频合成节点（VHS_VideoCombine），需要系统安装 ffmpeg

已内置模型权重

类型	文件名	说明
底模（UNET）	minimax_h3_fl2va_int8_convrot.safetensors	FL2VA 标准量化版，与 Turbo LoRA 兼容
加速 LoRA	minimax_h3_turbo_4步加速ema_comfyui.safetensors	4 步加速，仅适配非剪枝底模
文本编码器	qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors	Qwen3-VL 32B 量化版
视频 VAE	minimax_h3_video_vae_fp16.safetensors
音频 VAE	minimax_h3_audio_vae_fp32.safetensors

⚠️ 权重通过软链接指向平台公共模型盘，不占用实例磁盘空间。

内置工作流

• H3_Turbo_Stable_4V4A.json：4 步视频 / 4 步音频稳定采样，适合快速出图验证
• 详见 examples/workflows/ 目录下其他变体（EXP 系列为实验性配置）

使用说明

1. 打开 ComfyUI 网页界面
2. 确认 MiniMax H3 Audio Conditioning (T8) 节点中 prompt、width、height、length 等参数
3. 首次运行建议用最小分辨率（如 480p 级别）验证流程通畅，再逐步提升分辨率/时长
4. 生成结果默认保存在 output/ 目录下

已知问题与注意事项

• 剪枝版底模与 Turbo LoRA 不兼容：使用 *_pruned_* 权重时会报 mat1 and mat2 shapes cannot be multiplied 矩阵维度错误，需搭配非剪枝底模使用 LoRA，或使用专门适配剪枝版的 LoRA
• 本地仅支持 768p 输出：2K 超分（H3-Regenerate-2K）未开源，需调用 MiniMax 官方 API
• VHS_VideoCombine 节点参数：部分版本对对象格式的 widgets_values 解析不一致，若前端报 Cannot read properties of null 报错，请手动确认文件名前缀、格式、保存开关等字段不为空
• 重复文件名会导致生成失败：filename_prefix 相同且已存在文件时会报 already exists. Exiting，请更换前缀或清理 output 目录

许可证声明

本镜像基于 MiniMax H3 Community License 开源模型构建，使用前请自行确认：

• 商用收入门槛（年收入超 2000 万美元需另行授权）
• 界面署名要求（需展示 "MiniMax H3" 字样）
• 地域限制条款（如有）

详见官方 LICENSE：https://huggingface.co/MiniMaxAI/MiniMax-H3/blob/main/LICENSE

更新日志

• v1.0：初始发布，集成 T8 音频条件节点、VideoHelperSuite，验证 4 步加速采样流程可用