Pika H3 Flex ComfyUI 本地部署指南：安装、模型与排错

可以通过匹配的 MiniMax H3 组件、Pika H3 Flex 适配器和官方工作流，在 ComfyUI 中搭建本地推理环境。本文按官方资料整理操作步骤，不是本地部署成功的实测报告。 本站是独立平台，目前提供 MiniMax H3 等已列出模型，尚未接入 Flex 本身。

资料核查日期：2026 年 11 月 9 日。本站未安装这些权重、执行 GPU 生成，也未测量兼容性、最低显存、磁盘占用、速度或输出质量。以下命令和参数来自官方说明，未在本机执行。

1. 先核对环境和许可

先阅读官方 Flex 模型卡及其链接的硬件说明。租用算力或下载权重前，核对实际文件格式、推理后端和显卡支持情况。ComfyUI 的通用系统支持不代表每个设备都支持特定 Flex 工作流或其中的量化算子。

需要判断的问题	本文验证状态	你需要核对什么
模型组件和模板参数	已按官方资料核对	当前模板与其下载链接是否配套
最低显存、内存、可用磁盘	本站未测量	实际文件、精度、卸载与解码设置
NVIDIA、AMD、Intel、Apple 兼容性	本站未测试	该工作流的后端、依赖和算子
生成速度与画质	本站未做基准测试	在明确配置下完成生成后记录

使用客户素材或交付作品前，先读隐私与商用说明。可下载权重不等于无限制商用或全球适用。本地推理仍有硬件、存储与运行成本，本站积分不能支付这些费用。

2. 安装或更新 ComfyUI

使用打包版本时，从官方安装入口选择适合的方式。Windows 的 Portable 指南说明了如何解压对应安装包并运行启动器。完成 ComfyUI 安装，不等于已验证 Flex 兼容性。

手动安装请按官方手动安装指南，先创建并激活独立 Python 环境，准备 Git，并按实际硬件安装对应 PyTorch 依赖。然后在该环境内运行：

git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
python -m pip install -r requirements.txt
python main.py

打开服务端打印的本地地址。这些命令以 Git、独立环境及匹配的 PyTorch 已就绪为前提，不是所有显卡通用的一键安装命令。

已有手动安装环境时，先备份工作流与本地修改、停止服务，激活对应环境，在它的 ComfyUI 目录运行：

git pull
python -m pip install -r requirements.txt
python main.py

Portable 或 Desktop 应使用对应安装包的更新方式，详见官方更新指南。不要更新了无关的系统 Python，就认为当前 ComfyUI 运行环境已经更新。

3. 选择一个官方工作流

进入 Template Library → Video，搜索 Pika H3 Flex。ComfyUI 官方 Flex 教程提供了三个工作流 JSON：

工作流	输入	官方列出的最低 ComfyUI 版本
Text to Video	提示词	0.43.2
Reference to Video	参考图片与提示词	0.30.0
First and Last Frame / FL2VA	首帧、尾帧与提示词	0.30.0

版本要求按上述核查日期的文档记录，不是本站测试通过的版本。找不到模板时，按官方说明更新实际运行环境及模板依赖，重启后再查看；也可从教程下载对应 JSON 并在 ComfyUI 中加载。不要用未经审查的第三方工作流替代后，直接认为能力相同。

4. 下载配套模型

使用所选模板教程里的下载链接，准备对应模式的底模、适配器，以及共享的编码器和 VAE。只试一个工作流时，无需同时下载两组模式专用文件。

模式	扩散模型文件名主体	Flex LoRA 文件名主体
文字 / 首尾帧	minimax_h3_fl2va_pruned_int8_convrot	pika_h3_flex_fl2va_v1_bf16
参考素材	minimax_h3_ref2va_pruned_int8_convrot	pika_h3_flex_ref2va_v1_bf16

官方目录结构如下，只需安装选中的底模与适配器，以及共享文件：

ComfyUI/models/
  diffusion_models/
    minimax_h3_fl2va_pruned_int8_convrot.safetensors
    minimax_h3_ref2va_pruned_int8_convrot.safetensors
  loras/
    pika_h3_flex_fl2va_v1_bf16.safetensors
    pika_h3_flex_ref2va_v1_bf16.safetensors
  text_encoders/
    qwen3vl_32b_minimax_h3_nvfp4_awq.safetensors
  vae/
    minimax_h3_video_vae_int8_convrot.safetensors
    minimax_h3_audio_vae_fp32.safetensors

确认下载完整、文件名正确，重启后在加载节点选择对应文件。外置模型目录需要配置搜索路径，可参照手动安装指南的 extra_model_paths.yaml 说明。下载体积和运行占用需要按实际版本核对；本文不推荐最低显卡，也不保证某个量化文件一定能放进特定显卡。

5. 保留发布的采样参数

官方模板使用六步采样，组合为 lcm、ManualSigmas，经 BasicGuider 使用 CFG 1.0，适配器强度为 1.0。保留模板中的 sigma 数列，让 FL2VA、Ref2VA 各自匹配对应底模，不要再叠加 Turbo 或 Lightning 加速 LoRA。这些参数取自官方教程，没有经过本站生成调优。

第一次排查使用简单提示词与已获授权、无敏感信息的输入，先保留模板默认参数，每次只改一个输入或设置。提示词指南解释了参考素材分工与声音描述。

完成生成后，检查文件能否打开、时长和画幅是否正确、声音是否存在。模型卡描述的是本地原生 480p/768p 与混合立体声音频，不包含 Pika 托管服务的全部高分辨率精修和分轨能力。保存工作流、软件版本、可用时的 seed，以及实际参数，和成片一起归档。

6. 按失败阶段排查

现象	优先检查
缺少模板或出现未知节点	运行版本、重启、模板依赖及官方工作流版本；不要盲目安装所有推荐的自定义节点
加载节点找不到模型	目录与搜索路径、下载完整性、准确文件名、所选模式
张量形状或权重不匹配	底模与适配器组合、编码器、VAE、模板要求的精度；保留最初错误
显存不足	区分加载、采样和解码阶段；关闭其他占用进程，检查文档支持的内存选项，每次只改一项；本文没有保证成功的设置
动作破碎或输出异常	先恢复原始模板、适配器强度及采样设置，再调提示词
没有声音或导出失败	音频 VAE、音频连线、最终保存节点及其编码错误，与官方 JSON 对照

记录 ComfyUI 版本、操作系统、显卡与后端、驱动和 PyTorch 版本、工作流 JSON、模型文件名、参数及最初错误。分享日志前移除私密提示词、媒体链接和凭证。本站浏览器或 API 任务请另看视频排错指南。

7. 本地推理与隐私

引入保密素材前检查所有节点。即使页面打开在 localhost，工作流仍可能包含云端 API、远程 URL、自定义代码、扩展或上传操作；首次下载模型也需要联网。本地页面地址本身不能证明推理完全离线。

如果项目要求离线处理，应先获取必要且获许可的文件与依赖，审查工作流和外联行为，再使用无敏感信息的输入，在预期网络限制下验证。还应保护本地成片、日志和工作流元数据。云端服务的区别及许可边界见隐私、删除与商用说明。