ComfyUI

ComfyUI 是节点式图像和视频工作流工具，可以直接使用 ComfyUI Cloud，也可以部署到本地运行。本指南介绍如何在本地 ComfyUI 中手动安装 LLMPool MiniMax H3 视频自定义节点，并调用平台的 MiniMax H3 视频能力。

步骤 1：下载并部署 ComfyUI

git clone https://github.com/comfy-org/comfyui.git
cd comfyui

建议为 ComfyUI 创建独立的 Python 虚拟环境，并按照本机硬件安装匹配的 PyTorch 版本。

macOS / Linux：

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements.txt

Windows PowerShell：

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements.txt

安装前先关闭 ComfyUI，然后将压缩包解压到 ComfyUI 的 custom_nodes 目录。最终目录结构应为：

ComfyUI/
└── custom_nodes/
    └── ComfyUI-LLMPool-MiniMax/
        ├── __init__.py
        ├── nodes.py
        └── README.md

不要把压缩包解压成重复的目录，例如 custom_nodes/ComfyUI-LLMPool-MiniMax/ComfyUI-LLMPool-MiniMax。

如果使用 ComfyUI Desktop 或 Windows Portable，请把插件解压到该实例实际使用的 custom_nodes 目录，并使用该实例对应的本地 Python 环境启动和加载插件。

在启动 ComfyUI 的同一个终端中设置：

macOS / Linux：

export LLMPOOL_API_KEY="<你的 Board API 密钥>"
export LLMPOOL_MINIMAX_BASE_URL="<LLMPool 服务根地址>"

Windows PowerShell：

$env:LLMPOOL_API_KEY = "<你的 Board API 密钥>"
$env:LLMPOOL_MINIMAX_BASE_URL = "<LLMPool 服务根地址>"

LLMPOOL_API_KEY 使用 Board API 密钥，不要使用 Admin JWT、Tenant Access Token 或 Metrics token。
LLMPOOL_MINIMAX_BASE_URL 是 LLMPool 服务根地址，例如 http://127.0.0.1:19324。插件会自动追加 /minimax/v2；不要填写 OpenAI 路径 /openai/v1，也不要重复填写 /minimax/v2。
不要把 API 密钥填写到节点输入框或工作流 JSON 中。

环境变量只对当前启动进程生效。修改后需要重启 ComfyUI。

在 ComfyUI 根目录启动：

python main.py

启动完成后访问：

http://127.0.0.1:8188

在节点菜单的 video/LLMPool 分类中，可以使用以下节点：

两个节点都支持 768P 分辨率、4-15 秒时长和随机种子。文生视频支持 16:9、4:3、1:1 比例；首帧节点使用输入图片的自适应比例。节点执行后会等待任务完成，将 MP4 下载到 ComfyUI 输出目录，并显示预览/下载结果。

找不到节点：确认目录名称和层级正确，并检查 ComfyUI 启动日志中的导入错误。
401：确认 LLMPOOL_API_KEY 是 Board API 密钥，并且设置在启动 ComfyUI 的同一进程中。
LLMPOOL_MINIMAX_BASE_URL 错误：确认填写的是 HTTP(S) 地址，不要填写 http://0.0.0.0；插件会自动处理 /minimax/v2。
任务失败或超时：检查 MiniMax H3 Product 是否可用、账户余额是否充足，以及 LLMPool 服务是否能访问上游。
首帧图片失败：首帧节点只接受一张图片，且图片编码后不能超过 30 MB。