这次我们来看一个小白向的 ComfyUI 本地视频生成流程用海螺 MiniMax H3 跑图生视频。很多朋友关心 8GB 显存到底能不能玩、10 系到 50 系显卡各自怎么加速、工作流怎么加载、模型怎么放、批量任务和 API 怎么接。这篇文章统一梳理一遍。MiniMax H3 是视频生成模型社区已经把它集成到 ComfyUI 里配合工作流可以做图生视频、文生视频以及一些长镜头和转场方案。标题里的“海螺”指的是 MiniMax 旗下产品线H3 模型在本地部署时常见的是 nvfp4 量化格式很多老卡和低显存卡能运行的前提就是这类量化格式把模型体积和推理开销压下来了。先说结论8GB 显存可以作为入门配置来测试但具体占用和速度取决于你用的模型格式、分辨率、帧数和采样步数不存在一个固定数字适用于所有情况。10 系到 50 系显卡都可以尝试不过老卡和 50 系新卡的加速路径差异很大需要按架构区分处理。这篇文章会带你把整条链路过一遍ComfyUI 怎么装、模型怎么放、工作流怎么导入、图生视频怎么验证、显存怎么看、 API 怎么调用、批量任务怎么做、老卡和新卡分别有哪些加速手段。建议先收藏然后跟着正文一步步来。1. MiniMax H3 核心能力速览能力项说明项目类型视频生成模型社区集成到 ComfyUI主要功能图生视频、文生视频、镜头转场、长镜头实验模型格式社区常见 nvfp4 量化格式也有原始精度版本显存需求8GB 可作为入门测试配置实际占用需按模型格式、分辨率、帧数实测硬件支持10 系到 50 系显卡均可尝试不同架构加速方案不同启动方式ComfyUI WebUI可通过秋叶整合包或命令行启动平台支持Windows 为主Linux 也可部署接口能力ComfyUI 自带 API 服务可提交工作流和任务批量任务支持 ComfyUI 队列可写脚本批量处理图片适合场景短视频前期测试、镜头概念验证、图片动效化、视频工作流学习这里要特别说清楚MiniMax H3 是一个模型不是独立的软件。你需要一个 ComfyUI 环境再把模型文件和对应的自定义节点装好最后导入工作流才能跑起来。2. 适用场景与使用边界MiniMax H3 图生视频适合这些场景短视频创作者想做图片动效测试比如人物轻微动作、镜头推进、背景流动。设计人员把静态图变成动态参考用于方案演示。ComfyUI 学习者练手理解视频模型的节点组合方式。内容团队在本地搭建批量生成链路批量对多张图片生成短视频素材。不推荐用本地 MiniMax H3 做这些事不推荐直接用未经授权的他人照片、影视截图、商业素材生成视频。不推荐在素材版权不清晰的情况下商用输出。不推荐把生成内容用于虚假信息、误导性视频、冒充他人身份等场景。视频生成模型本身是一个工具使用边界取决于你输入什么素材、生成什么内容。在使用前务必确认素材的合法授权。如果涉及人物肖像需要本人同意如果涉及品牌、影视、音乐等内容要考虑版权风险。3. 环境准备与前置条件先把软硬件条件列出来少了哪一项后面跑不起来你也能快速定位。3.1 硬件要求显卡NVIDIA 显卡优先8GB 显存可作为入门测试配置。10 系、20 系、30 系、40 系、50 系都有人跑过但体验差异很大。内存建议 16GB 以上。加载大模型时内存不足会导致启动失败。硬盘预留至少 30GB 空间。模型文件普遍较大工作流和输出素材也要占空间。3.2 软件要求Windows 10 或 Windows 1164 位系统。显卡驱动建议更新到较新版本。50 系显卡需要新驱动和较新的 CUDA 运行库。如果使用官方 ComfyUI 安装方式需要 Python 3.10 到 3.12。如果使用秋叶整合包Python 和依赖环境已经内置不需要单独装。3.3 检查显卡驱动和 CUDA打开命令行执行以下命令检查驱动环境nvidia-smi正常情况下会显示显卡型号、驱动版本、CUDA 版本。如果你的 50 系显卡显示的 CUDA 版本比较旧更新驱动后再安装对应版本的 PyTorch。10 系和 20 系老卡需要注意驱动版本不能太新也不能太旧建议使用稳定版驱动。3.4 磁盘和目录规划建议在启动前把目录规划好comfyui-root/ ├── ComfyUI/ ├── models/ │ ├── diffusion_models/ │ ├── vae/ │ └── ... ├── custom_nodes/ ├── input/ ├── output/ └── workflows/models/diffusion_models放主模型文件。models/vae放 VAE 文件。custom_nodes放自定义节点。input放测试图片。output放生成结果。workflows放你导入的工作流 JSON。4. 安装部署与启动方式ComfyUI 的安装方式主要有两种秋叶整合包和官方命令行安装。小白建议直接用整合包省去大量环境配置时间。4.1 方式一秋叶 ComfyUI 一键整合包这是国内社区最常见的部署方式。搜索“秋叶 ComfyUI 整合包”即可找到对应版本下载后解压运行启动脚本。整合包的好处Python、PyTorch、ComfyUI 主程序全部内置。自带 ComfyUI Manager方便安装节点。启动脚本做了依赖隔离不会污染系统 Python。内置了国内源切换选项下载模型和节点时速度更快。启动流程一般是双击启动脚本看到命令行出现Starting server之后浏览器会自动打开http://127.0.0.1:8188。如果浏览器没有自动打开手动访问这个地址即可。4.2 方式二官方命令行安装如果你更习惯自己掌控环境可以用官方方式。以 Windows 为例在命令行执行git clone https://github.com/ComfyUI/ComfyUI.git cd ComfyUI python -m venv venv venv\Scripts\activate pip install -r requirements.txt国内网络下载 PyTorch 可能慢可以切换到国内镜像源。以清华源为例pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple启动服务python main.py --port 8188 --lowvram--lowvram会限制显存占用适合 8GB 显存环境。如果你使用的是老卡还可以尝试python main.py --port 8188 --lowvram --disable-smart-memory这些参数的作用在后面的加速方案里详细说明。4.3 安装 ComfyUI ManagerComfyUI Manager 是节点管理的核心工具。整合包通常已经内置如果是官方安装方式可以在custom_nodes目录下克隆cd custom_nodes git clone https://github.com/ltdrdata/ComfyUI-Manager.git cd ComfyUI-Manager pip install -r requirements.txt安装完成后重启 ComfyUI界面右侧会出现 Manager 按钮。通过 Manager 可以搜索缺少的自定义节点。如果网络慢在 Manager 设置里切换镜像源。4.4 启动后确认状态启动成功后的标志浏览器能打开http://127.0.0.1:8188。ComfyUI 界面底部没有“Failed to load”之类的红色报错。custom_nodes里能看到待用的节点列表。端口冲突很常见。如果你的 8188 端口被占用命令行会报错。此时换端口启动python main.py --port 81895. MiniMax H3 模型下载与工作流加载模型没有内置在整合包里需要单独下载。常见的社区模型格式是 nvfp4 量化版这类文件体积相对小适合 8GB 显存尝试。5.1 模型文件放置下载后的模型文件名可能是一长串 hash 值建议重命名为容易识别的名称比如minimax_h3_nvfp4.safetensors然后放到对应目录。定位方式如下打开 ComfyUI 界面找到加载模型的节点 Load Diffusion Model。点击文件名选择框可以看到当前models/diffusion_models目录里的模型文件。新放进去的模型如果没出现点击选择框旁边的刷新按钮。部分工作流可能要求模型放在models/checkpoints或models/unet具体看工作流中节点是怎么设置的。最稳妥的做法是打开工作流 JSON搜索模型节点的路径和文件名然后把对应文件放到对应目录。5.2 VAE 文件放置图生视频工作流一般需要 VAE 节点。把 VAE 文件放到models/vae目录。如果节点提示找不到 VAE在工作流中检查 VAE 节点指向的文件名是否与实际一致。5.3 自定义节点安装MiniMax H3 工作流通常依赖专门的视频生成节点。在 ComfyUI Manager 中搜索相关节点名。如果找不到可以把工作流 JSON 打开查看custom_nodes部分引用了哪些节点再逐个安装。安装节点后必须重启 ComfyUI否则节点不会出现在界面上。常见流程打开 Manager。点击 Install Custom Nodes。搜索视频生成相关节点。安装完成后点击 Restart。有些节点还依赖额外 Python 包安装时如果失败需要手动到custom_nodes对应目录下执行pip install -r requirements.txt5.4 导入工作流ComfyUI 工作流是 JSON 文件导入方式两种方式一直接把 JSON 文件拖入浏览器画布ComfyUI 会自动加载节点布局。方式二在界面顶部点击 Workflow - Open选择 JSON 文件。加载后检查节点是否全部呈现为白色。如果某个节点显示红色说明缺少对应自定义节点或模型文件。5.5 导演台全能工作流这套工作流在社区中传播较广适合小白快速出片。它通常包含提示词输入节点、图生视频节点、视频输出节点并且默认参数相对保守。导入后你需要做的第一件事不是直接跑而是检查几个关键位置加载的模型文件是否对应你下载的 MiniMax H3 文件。VAE 路径是否正确。输入图片节点引用的文件是否存在。输出视频目录是否有写入权限。6. 图生视频功能测试与效果验证跑通任何视频模型都不要一上来就生成高分辨率长视频。先小参数测试确认链路完整再逐步加大。6.1 测试目的验证 MiniMax H3 在 ComfyUI 中是否能正常加载模型、读取输入图片、输出视频文件。6.2 输入素材准备最好准备一张自己拍摄的图片或者授权可用的图片。推荐选择带有明显动态空间的画面比如人物的头发或衣角有飘动空间的半身照。街景、海面、云层等自然场景。有明显透视关系的场景便于观察镜头运动效果。图片分辨率建议不要过大先在 512 到 768 区间测试避免显存瞬间打满。6.3 操作步骤把测试图片放到 ComfyUI 的input目录。在工作流中加载图片节点选择这张图片。确认提示词。例如中文人物看向远处镜头缓慢推进微风拂过头发。英文the woman looks into the distance, camera slowly moves forward, gentle breeze blows her hair。将视频长度设置为短片段例如 2 到 4 秒。分辨率按你的显卡能力设置8GB 显存建议从 640x480 或 768x512 开始。点击 Queue Prompt。6.4 预期结果队列中出现任务进度条移动。命令行显示采样进度。控制台没有CUDA out of memory报错。完成后输出目录出现 mp4 或视频预览文件。视频内容是输入图片的动态扩展而非黑屏或纯色画面。6.5 判断成功的标准如果生成的视频能清晰看到画面主体保持同时出现合理的运动效果说明整个链路已经跑通。此时再尝试更长的时长和更高分辨率。6.6 常见失败原因失败现象可能原因提示模型文件不存在模型放错目录提示找不到节点自定义节点未安装CUDA out of memory分辨率或帧数过高生成黑屏VAE 缺失或模型加载失败画面完全不动提示词未正确输入队列卡住采样步数过大或显卡驱动异常7. MiniMax H3 接口 API 调用示例ComfyUI 本身就是前后端分离的服务这意味着你可以通过 HTTP 请求提交任务。对于批量任务和自动化流程这比手动点击画布高效得多。7.1 启动 API 服务ComfyUI 默认启动后就会监听 HTTP 端口比如http://127.0.0.1:8188。官方接口有两个常用端点/prompt提交任务。/history查询任务状态和结果。7.2 通过 API 提交任务先获取工作流 JSON。把你在画布中导入的工作流保存为文件然后用 Python 读取将workflow部分作为 API 请求参数。实际提交时需要用prompt字段包裹工作流信息。以下是一个通用的 Python 调用模板。注意不同节点类型的名字和参数不同你需要把自己工作流中的节点对应替换进去import json import requests # 1. 读取工作流 JSON 文件 with open(minimax_h3_workflow.json, r, encodingutf-8) as f: workflow json.load(f) # 2. 找到加载图片的节点替换为实际路径 for node_id, node_data in workflow.items(): if node_data.get(class_type) LoadImage: # 假设图片文件名是 test.png实际请替换为你的图片 node_data[inputs][image] test.png # 3. 提交到 ComfyUI api_url http://127.0.0.1:8188/prompt payload { prompt: workflow, client_id: my-client-001 } response requests.post(api_url, jsonpayload, timeout30) print(response.json())如果返回结果包含prompt_id说明任务已经进入队列。7.3 查询任务状态用返回的prompt_id查询状态。history接口会返回该 id 对应的执行结果。curl http://127.0.0.1:8188/history/YOUR_PROMPT_ID如果history中能查到输出文件信息说明任务执行成功。某些 ComfyUI 版本需要返回的是保存视频节点的输出路径你可以通过/view或文件系统直接访问输出目录。7.4 批量任务设计思路批量任务的核心思路是循环替换输入图片然后提交多次任务。简单伪代码如下import os import requests import json import time api_url http://127.0.0.1:8188/prompt with open(minimax_h3_workflow.json, r, encodingutf-8) as f: workflow json.load(f) input_dir ./inputs output_log ./batch_log.txt for filename in os.listdir(input_dir): if not filename.lower().endswith((.png, .jpg, .jpeg)): continue # 克隆工作流避免相互污染 current_workflow json.loads(json.dumps(workflow)) # 替换图片节点 for node_id, node_data in current_workflow.items(): if node_data.get(class_type) LoadImage: node_data[inputs][image] filename resp requests.post(api_url, json{prompt: current_workflow}, timeout30) result resp.json() if prompt_id in result: with open(output_log, a, encodingutf-8) as f: f.write(f{filename}: {result[prompt_id]}\n) print(fsubmitted: {filename}) else: print(ffailed: {filename} - {result}) time.sleep(1)这段代码的用途是演示循环提交任务而不是直接贴进生产环境。真实批量链路还要加入状态检查、失败重试、超时控制和输出文件整理。7.5 批量任务注意事项批量数量要控制一次提交太多任务会让显存和内存同时打满。建议每提交几个任务等待前几个完成后再继续。结果文件管理中建议用输入文件名加上时间戳命名输出视频。任务失败时记录失败原因并重试。8. 10 系到 50 系显卡加速方案汇总MiniMax H3 这类视频模型在不同代际显卡上的加速方案差异很大这是很多新手最容易踩坑的地方。下面按架构分类说明。8.1 10 系显卡Pascal 架构10 系显卡没有现代 Tensor Core对半精度推理的支持有限。社区反馈它能跑但速度慢而且内存拷贝频繁。可尝试的方案优先使用 nvfp4 等低精度量化模型减小显存和带宽压力。使用--lowvram启动让显存和内存之间动态调度。降低分辨率到 512 以下、帧数减少先验证可行性。不要同时开多个浏览器窗口和任务队列减少显存碎片。从材料看10 系跑 MiniMax H3 属于“能出片但速度不理想”的范畴适合学习验证流程不适合批量生产。8.2 20 系显卡Turing 架构20 系显卡带 Tensor Core可以较好地支持 FP16 推理。比 10 系流畅但仍属于显存相对紧张的梯队。建议使用 FP16 或 nvfp4 模型格式。启动时加上--fp16 --lowvram相关参数。分辨率保持在 768 以下视频长度控制在 2 秒到 4 秒。8.3 30 系显卡Ampere 架构30 系是目前的常用测试平台8GB 型号在低分辨率短视频上可以尝试。加速思路使用量化模型格式如 nvfp4。优先用较新版本的 PyTorch对 Ampere 架构有更好优化。适当使用 VAE 单独加载减少主模型显存压力。设置合理的采样步数不要盲目堆高步数。8.4 40 系显卡Ada Lovelace 架构40 系整体流畅度更好可以尝试更高分辨率和更长时长。显存较小的 4060 系列仍需控制参数。建议使用量化模型格式降低显存占用。使用 ComfyUI 的--fast参数或启用相关加速选项。观察显存占用逐步尝试 720p 或 1080p 短视频。如果使用 40 系大显存显卡可以同时跑多个队列任务。8.5 50 系显卡Blackwell 架构50 系显卡是最新架构需要较新的驱动、较新的 CUDA 版本和匹配的 PyTorch 版本。如果老版本 PyTorch 不识别 50 系可能直接报 CUDA 初始化失败。建议更新到最新显卡驱动。安装对应 CUDA 版本的最新 PyTorch。使用支持 Blackwell 的新版 ComfyUI。如果自定义节点与新版 PyTorch 冲突优先更新节点。一个通用的提醒50 系虽然在算力上更强但很多自定义节点和第三方组件没有及时跟上适配部署时优先从官方渠道获取最新版本。8.6 通用加速手段使用量化模型nvfp4 等格式能显著降低模型体积和显存占用适合 8GB 显存。调低分辨率视频模型的分辨率升高显存压力成倍增加。缩短视频长度帧数减少显存占用下降。精简提示词节点某些提示词和长文本处理节点也会占用显存。关闭多余浏览器标签和后台程序浏览器本身对显存有占用。切换国内源下载模型时使用镜像加速减少等待时间。9. 资源占用与性能观察运行 MiniMax H3 时除了看最终视频还要学会观察资源占用。这决定了你能不能继续调高参数。9.1 查看显存占用在 Windows 上使用任务管理器打开任务管理器。切换到“性能”选项卡。点击 GPU查看“专用 GPU 内存”使用量。更精确的方式是用命令行nvidia-smi这个命令会实时显示每个进程的显存占用。你会看到python.exe进程占用了多少显存。如果接近 8GB说明当前参数已经接近上限。9.2 CPU 推理与 GPU 推理的差异GPU 推理速度远快于 CPU。但如果你在 10 系老显卡上遇到显存不足可以尝试 GPU 加载模型、CPU 处理部分算子使用--lowvram当显存不够时把中间数据写回内存。观察系统内存占用如果内存也高说明模型切换频繁。CPU 推理只建议在无 NVIDIA 显卡的机器上测试速度会很慢。更稳妥的判断是先看 8GB 显存环境下模型文件是多大。如果模型文件本身超过 8GB需要用--lowvram和量化格式配合否则不可能一次加载。9.3 分辨率、步数、帧数对性能的影响分辨率宽和高同时提升显存占用近似平方增长。帧数视频帧是连续的图像生成任务帧数翻倍耗时近似翻倍。采样步数步数增加耗时会线性增加但画面质量不一定同步提升。批量大小ComfyUI 队列里的任务数量也影响整体调度不过显存占用主要看单个任务。9.4 降低显存占用的有效手段使用量化模型文件而不是原始高精度文件。关闭 ComfyUI 界面的实时预览某些预览功能会在生成过程中额外占用资源。只保留基础节点去掉不必要的放大和修复节点。生成视频长度先控制在 2 秒到 3 秒成功后再延长。如果频繁CUDA out of memory在启动命令中加上--lowvram并用更小的分辨率测试。9.5 端口冲突和进程残留ComfyUI 进程被强退后端口可能仍被占用。Windows 下可以执行netstat -ano | findstr 8188找到占用端口的 PID 后确认是残留的 python 进程再结束taskkill /PID 12345 /F这段操作只在确认没有其他重要任务运行时使用。10. MiniMax H3 常见问题与排查方法下面按“现象 - 可能原因 - 排查方式 - 解决方案”整理了一份排查表。大部分问题集中在环境配置和资源不足不涉及模型本身的算法问题。问题现象可能原因排查方式解决方案启动后页面打不开端口被占用或服务未启动查看命令行日志检查 8188 端口换端口启动或关闭占用进程模型文件找不到文件放错目录查看模型节点路径检查 models 目录把模型放到对应目录并刷新自定义节点显示红色节点未安装或依赖缺失查看控制台报错通过 Manager 安装或手动装依赖报 CUDA out of memory参数设置过高降低分辨率和帧数使用 --lowvram改用量化模型显卡驱动版本过旧50 系显卡未被识别运行 nvidia-smi 查看驱动更新驱动并重装匹配的 PyTorch生成视频黑屏VAE 缺失或模型加载失败检查 VAE 节点下载并放置 VAE重新加载工作流提示词不生效输入节点与模型未连接检查工作流连线按原始工作流重新连接节点API 提交后任务报错工作流节点参数不合法查看任务历史响应对比手动运行时参数修正后重提批量任务卡在某一项显存或内存不足查看任务管理器减少并发加失败重试机制下载模型速度慢网络原因检查网络连接使用国内镜像源或分时段下载启动时依赖安装失败网络问题或 Python 版本不匹配查看 pip 报错切换镜像源确认 Python 版本推理速度很慢老显卡或参数过高查看 GPU 利用率降低分辨率使用加速参数10.1 关于下载和文件完整性的提示模型文件下载后如果加载报错优先做文件校验。最常见的问题是下载中断导致文件不完整。如果下载工具不支持校验可以删除后重新下载。10.2 关于量化格式的理解nvfp4 是一种低比特量化格式。它的意义是压缩模型体积让 8GB 显存有机会运行大模型。但量化格式本身需要模型转换和节点支持不是所有工作流都对它友好。使用量化模型时尽量选择和它匹配的 ComfyUI 节点版本。11. 最佳实践与使用建议11.1 第一次先小参数测试不管目标分辨率是 1080p 还是 4K第一次运行都不要直接拉满。先用小分辨率、短视频、低步数跑通整个链路确认没有报错后再逐步提升。推荐的第一组参数视频长度2 秒。分辨率640x480 或 768x512。步数按工作流默认值或稍低。批量数1。11.2 保留一套最小可运行配置跑通后立刻把工作流导出为 JSON 存档连同模型文件名、输入图片路径、参数设置一并记录。后续调参出现问题可以随时回退到这套配置。11.3 分目录管理素材建议按以下结构组织projects/ ├── images/ │ └── batch_001/ ├── outputs/ │ └── batch_001/ ├── workflows/ │ └── minimax_h3_basic.json └── logs/ └── batch_log.txt这样批量任务、结果回溯和故障排查都会轻松很多。11.4 批量任务要加日志和失败重试批量生成视频时间很长中途掉卡、显存不足、模型加载失败都可能发生。脚本必须记录每个任务的状态和失败原因对可恢复的失败做有限重试。重试策略建议每个任务最多重试 2 次。重试间隔 5 到 10 秒。如果连续失败停止队列并发送提醒。11.5 接口服务要控制访问范围ComfyUI 默认监听本地地址。如果开放到局域网建议绑定固定 IP 并设置访问限制避免别人随意提交任务。生产环境不要直接暴露在公网。11.6 涉及人脸、声音、版权素材时要确认授权视频模型最大的风险在输入素材。自己拍摄的照片可以直接用网络下载的图片需要确认授权含有他人肖像的材料必须征得同意涉及品牌 logo 和影视画面的内容要在发布前仔细审查。11.7 发布或商用前复核本地生成的视频不代表最终质量也不代表内容合规。发布前检查画面是否清晰、有无明显变形。人物是否有不合理的外观突变。是否包含未经授权的元素。是否与素材来源的版权许可冲突。12. 总结与下一步MiniMax H3 在 ComfyUI 中跑图生视频是一条可以直接落地的链路。最值得尝试的点在于通过 nvfp4 量化格式让 8GB 显存级别的显卡有机会本地生成短视频而且整个链路可以通过 API 和批量脚本扩展成半自动化工具。最先应该验证的功能不是画质而是链路是否完整模型能不能加载、图片能不能读取、视频能不能输出。先跑通三步再调参数。最容易踩的坑有三个模型文件放错目录、自定义节点未安装、参数一开始就拉满导致显存不足。这三个问题占了大部分群友的求助帖。后续可以继续扩展的方向接入更多图像模型把图片生成和图生视频串成一套工作流。批量镜头预演用几十张分镜图生成动态参考辅助前期导演决策。把 ComfyUI 的输出接到视频剪辑流程中实现自动化的素材生产链路。尝试更长片段和更复杂的转场节点探索本地视频生成的极限。建议先按本文流程跑通一次基础图生视频再根据自己的显卡和需求逐步调整。收藏这篇文章遇到问题时回来对照排查表。