安装节点#
使用 Python 3.10+，以及支持原生 V3 DynamicCombo 和 Save Video 的新版 ComfyUI。你可以通过 Comfy Registry 安装，也可以使用下方的手动下载方式。
通过 Comfy Registry 安装#
先激活 ComfyUI 的 Python 环境，再安装 comfy-cli。将 /path/to/ComfyUI 替换为包含 main.py 的实际目录。
python -m pip install -U comfy-cli确认该 ComfyUI 环境已安装 ComfyUI-Manager，然后执行以下命令，刷新节点目录并安装 CheaperGen。
comfy --workspace "/path/to/ComfyUI" node install comfyui-cheapergen --mode remote--mode remote 会在安装前联网刷新 Manager 的节点目录。首次刷新可能需要几分钟，并且需要能够访问 Comfy Registry。安装完成后重启 ComfyUI，无需另行下载 ZIP。
如果不使用 ComfyUI-Manager，也可以改用以下命令，直接从 Comfy Registry 安装。
comfy --workspace "/path/to/ComfyUI" node registry-install comfyui-cheapergen手动安装#
下载 ZIP，将其中的 ComfyUI-CheaperGen 文件夹解压到 custom_nodes，并用 ComfyUI 自身的 Python 安装 requirements.txt。该文件夹下应直接包含 __init__.py。安装后重启 ComfyUI。
unzip ~/Downloads/ComfyUI-CheaperGen-Unified-0.5.0.zip -d /path/to/ComfyUI/custom_nodes
/path/to/ComfyUI/.venv/bin/python -m pip install -r /path/to/ComfyUI/custom_nodes/ComfyUI-CheaperGen/requirements.txt将示例路径替换为实际安装路径。Desktop 可能使用独立的 custom_nodes 目录，请以启动日志为准。升级时保留 user/cheapergen 状态目录。
连接账户#
在 Dashboard 创建 API Key 并充值。在启动后端的环境中设置 CHEAPERGEN_API_KEY 后重启。不要把密钥写入工作流 JSON；同一后端的用户共用密钥和余额。
export CHEAPERGEN_API_KEY='your-api-key'Image 和 Video 节点#
CheaperGen · Image#
选择 Model 和 Generation mode 后显示对应参数与 IMAGE 输入。将 images 连接到 Save Image 或 Preview Image，图片结果保留原始尺寸。
CheaperGen · Video#
选择模型和模式，将 video 连接到 Save Video。图生视频可把 Load Image 或 Image.images 接到 image_url。原生 VIDEO 输出保留音轨。
image_urls_json、video_url 和 generation_id 是文本输出，可接 Preview as Text 查看或复制。通过 images 或 video 保存媒体时，这些文本端口可以留空。
示例工作流#
下载 JSON 示例，在 ComfyUI 中打开或拖入；图片输入请选择自己的文件。工作流末尾需要 Save Image、Preview Image 或 Save Video 输出节点。
CheaperGen · Image → Save Image
CheaperGen · Video → Save Video
CheaperGen · Image (images) → CheaperGen · Video (image_url) → Save Video预算与任务标识#
max_cost_usd 是预算上限，不是报价。视频示例使用 Seedance 2.0 Mini、480p、4 秒和 $0.50 上限。Run 会检查价格并可能消耗余额。allow_fallback_price 默认关闭。
输入和 request_token 不变时会复用原任务，避免重复付费；修改参数会识别为独立请求。只有想用相同设置再付费生成一次时，才点击 New paid generation；按钮本身不提交任务。
提交成功后显示 Current generation ID 和复制按钮；普通输出端口要等节点生成并下载结束才可用。未提交任务就没有新的 ID。
Interrupt 和 wait_timeout 仅停止本地等待，服务端仍可能继续执行和计费。再次尝试前请查看 Dashboard，并在升级时保留 user/cheapergen 状态目录。