MiniMax-H3 WebUI 是一个专为 ComfyUI + MiniMax-H3 打造的轻量级、自托管视频生成前端。它摒弃了复杂的节点编辑界面,采用“三视图合一”的设计(对话流、总览、Studio),为用户提供从参数配置、实时进度监控到历史管理的一站式体验。该工具完全基于原生 JavaScript 构建,零框架依赖,后端仅利用 ComfyUI 自带环境,实现了极低的部署门槛和极高的运行效率。
- GitHub:https://github.com/AntaresAlice/h3-webui

核心功能亮点
- 三视图无缝切换:
- 对话流 (Chat):聊天式交互,适合快速测试提示词与参数。
- 总览 (Grid):网格化展示作品,便于批量浏览与管理。
- Studio (Workbench):专业工作台,提供详细的参数控制、历史记录与续写功能。
- 真实步数进度反馈:
- 通过 WebSocket 桥接 ComfyUI,利用 SSE 推送真实的采样步数进度(如
3/8),彻底告别虚假的定时器进度条。
- 通过 WebSocket 桥接 ComfyUI,利用 SSE 推送真实的采样步数进度(如
- 视频续写与叙事连贯性:
- 支持一键续写:自动抽取上一段视频的最后一帧作为下一段的参考首帧,实现连续叙事的无缝衔接。
- Ref2VA 多素材参考支持:
- 支持 1-9 张参考图的多素材引用(r2v 模式),内置官方六段式提示词骨架,一键插入
<Picture N>占位符,精准控制角色与场景一致性。
- 支持 1-9 张参考图的多素材引用(r2v 模式),内置官方六段式提示词骨架,一键插入
- 原生音频输出:
- 直接生成带声音的视频(H3 原生 Audio VAE),浏览器内支持 Range 流式播放与进度条拖拽。
- 轻量化与零依赖:
- 前端纯原生 JS,无 React/Vue 等重型框架;后端复用 ComfyUI 自带的 Python 环境(aiohttp/Pillow/PyAV),无需额外安装依赖。
- 工作区隔离:每个工作区拥有独立的
generations.json与媒体目录,方便项目分类管理。
模型与依赖清单
在使用前,请确保已在 ComfyUI 中安装 MiniMax-H3 官方自定义节点,并下载以下模型至对应目录:
| 用途 | 推荐文件 | 存放目录 |
|---|---|---|
| DiT 主模型 | minimax_h3_fl2va_pruned_int8_convrot.safetensors (快)minimax_h3_fl2va_int8_convrot.safetensors (优) | models/unet/ |
| 视频 VAE | minimax_h3_video_vae_fp16.safetensors | models/vae/ |
| 音频 VAE | minimax_h3_audio_vae_fp32.safetensors | models/vae/ |
| 文本编码器 | qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors | models/clip/ |
| Turbo LoRA | minimax_h3_fl2v_turbo_4step_v1.0... (4步)minimax_h3_fl2v_turbo_8step_v1.0... (8步) | models/loras/ |
| Ref2VA 模型 | minimax_h3_ref2va_pruned_int8_convrot.safetensors | models/diffusion_models/ |
快速启动 (Windows)
方式一:一键脚本(推荐)
# 使用默认 D:\ComfyUI 或指定路径
run_webui.bat D:\Your\ComfyUI\Path
脚本会自动检测 ComfyUI 状态(端口 8188),若未运行则后台拉起,随后启动 WebUI 并自动打开浏览器访问 http://127.0.0.1:8080。
方式二:手动启动
- 终端 1:启动 ComfyUI。
- 终端 2:进入 WebUI 目录,使用 ComfyUI 自带 Python 运行
webui/server.py。
使用流程建议
- 创建工作区:在顶部新建或切换工作区,确保历史记录独立。
- 上传参考:拖拽图片或视频素材,系统自动校验并上传至 ComfyUI input 目录。
- 配置参数:
- 选择 i2v (单图) 或 r2v (多素材) 模式。
- 调整分辨率预设(15种 32 倍数)或 Native 模式。
- 开启 Turbo LoRA 自动匹配以加速生成。
- 生成与监控:点击生成,观察右侧实时步数进度。
- 续写与复用:在 Studio 历史列表中选中视频,点击 ⏩ 续写 或 ♻️ 复用参数,快速开启下一轮创作。
© 版权声明
文章版权归作者所有,未经允许请勿转载。















