快速入门 - ComfyUI

概述

comfy-cli 是一个命令行工具，可以帮助更轻松地安装和管理 Comfy。它提供两大功能：

管理本地 ComfyUI 安装 — 安装、启动、更新、快照和二分调试 ComfyUI 及其自定义节点。
直接调用托管的合作节点 — 使用一条命令即可从 Seedance、Nano Banana（Gemini）、Grok、Flux、Ideogram、DALL·E、Recraft、Stability、Kling、Luma、Runway、Pika、Vidu、Hailuo、Moonvalley 等合作伙伴生成图片和视频。无需本地 ComfyUI 或工作流 JSON。

安装 CLI

pip install comfy-cli

brew tap Comfy-Org/comfy-cli
brew install comfy-org/comfy-cli/comfy-cli

获取 shell 自动补全提示：

comfy --install-completion

安装 ComfyUI

使用任意高于 3.9 的 Python 版本创建一个虚拟环境。

conda create -n comfy-env python=3.11
conda activate comfy-env

python3 -m venv comfy-env
source comfy-env/bin/activate

安装 ComfyUI

comfy install

您仍然需要根据您的 GPU 安装 CUDA 或 ROCm。

运行 ComfyUI

comfy launch

使用 `comfy generate` 直接调用合作节点（Beta）

comfy generate 目前处于 Beta 阶段。 参数名称、模型别名及输出格式可能会根据反馈进行调整。底层合作节点接口是稳定的——仍在演进的是 CLI 的使用体验。如有反馈或问题，请提交至 comfy-cli GitHub 仓库。

comfy generate 是在终端或脚本中调用 Comfy 合作节点的最快方式。它调用的是同一个托管端点——只不过以一次性 CLI 调用的方式——非常适合批量任务、快速实验和自动化管线，而无需搭建完整的 ComfyUI 工作流。

前置条件

设置密钥一次，然后即可开始：

export COMFY_API_KEY=comfyui-...   # 或在每次调用时传入 --api-key

您的首次生成

comfy generate flux-pro \
    --prompt "a cat on the moon, cinematic lighting" \
    --width 1024 --height 1024 \
    --download cat.png

搞定——CLI 会自动上传本地文件、提交任务、轮询至完成，并将结果保存到 cat.png。

热门模型

以下是一些最常用的合作模型，一行命令即可调用：

# Nano Banana（Google Gemini Flash Image）— 文生图和提示词驱动的编辑
comfy generate nano-banana \
    --prompt "a watercolor of a sleeping fox" \
    --download fox.png

# 同一别名，现在进行图片编辑——传入 --image（可重复使用）作为参考图：
comfy generate nano-banana \
    --prompt "add a top hat" \
    --image ./cat.png \
    --download edited.png

# 选择 Gemini 变体：
comfy generate nano-banana \
    --prompt "neon city skyline" \
    --model gemini-3-pro-image-preview \
    --download city.png

# Seedance（字节跳动）— 文生视频，最高 1080p / 12 秒
comfy generate seedance \
    --prompt "a hummingbird hovering over a flower" \
    --resolution 1080p --duration 5 \
    --download hummingbird.mp4

# Seedance 图生视频——选择 lite/i2v 变体并传入首帧
comfy generate seedance \
    --model seedance-1-0-lite-i2v-250428 \
    --prompt "the wave crests and crashes" \
    --image ./still.jpg \
    --download wave.mp4

# Grok（xAI）— 图片生成和编辑
comfy generate grok --prompt "a cyberpunk street market at night" --download street.png
comfy generate grok-edit --prompt "swap the umbrella for a parasol" --image ./photo.jpg --download out.png

# Grok 视频
comfy generate grok-video --prompt "a paper plane gliding through a cathedral" --download flight.mp4

发现模型

comfy generate list                            # 所有可用模型
comfy generate list --category text-to-video   # 按类别筛选
comfy generate list --partner kling            # 按合作方筛选
comfy generate schema flux-kontext             # 查看某模型的参数

使用参考图片进行编辑

直接传入本地文件路径——CLI 会通过 Comfy 的存储端点上载（或根据合作方需求进行 base64 编码内联传输）：

comfy generate flux-kontext \
    --prompt "add a top hat and a monocle" \
    --input_image ./photo.jpg \
    --download out.png

comfy generate ideogram-edit \
    --image cat.png --mask mask.png \
    --prompt "add sunglasses" \
    --rendering_speed TURBO \
    --download edited.png

如果您希望上传一次后多次复用签名 URL：

comfy generate upload ./photo.jpg
# → 打印一个签名 URL，可作为 --input_image 传入

上传的参考资源会在 24 小时 后自动删除。它们存储在 Comfy 管理的 GCS 存储桶中，通过签名 URL 提供服务。对于大多数工作流（上传 → 使用 → 完成），这个过程是透明的；对于长时间运行的管线，请在每次任务前重新上传。详情请参见参考文档。

视频生成（异步任务）

视频任务是异步的——CLI 默认会阻塞等待，轮询至完成：

comfy generate kling \
    --prompt "a paper boat drifting on a river at dusk" \
    --duration 5 \
    --download boat.mp4

传入 --async 可立即返回任务 ID，稍后继续：

comfy generate luma --prompt "neon koi swimming through clouds" --aspect_ratio 16:9 --async
# → 打印任务 ID；稍后继续：
comfy generate resume luma <job_id> --download out.mp4

通过 JSON 输出编写脚本

对于管线，--json 可以输出原始 API 响应：

comfy generate dalle --prompt "a watercolor whale" --json | jq '.data[0].url'

完整命令、参数和模型别名列表请参见参考文档。

管理自定义节点

comfy node install <NODE_NAME>

我们使用 cm-cli 来安装自定义节点。更多信息请参阅文档。

管理模型

使用 comfy-cli 下载模型非常简单。只需运行以下命令：

comfy model download --url <url> --relative-path models/checkpoints

贡献

我们鼓励对 comfy-cli 做出贡献！如果您有建议、想法或错误报告，请在我们的 GitHub 仓库上提交问题。如果您想贡献代码，请 fork 仓库并提交 pull request。更多详细信息请参见开发指南。

数据分析

我们会跟踪 CLI 的使用情况以改进用户体验。您可以通过运行以下命令禁用此功能：

comfy tracking disable

要重新启用跟踪，请运行：

comfy tracking enable

​概述

​安装 CLI

​安装 ComfyUI

​运行 ComfyUI

​使用 comfy generate 直接调用合作节点（Beta）

​前置条件

​您的首次生成

​热门模型

​发现模型

​使用参考图片进行编辑

​视频生成（异步任务）

​通过 JSON 输出编写脚本

​管理自定义节点

​管理模型

​贡献

​数据分析

概述

安装 CLI

安装 ComfyUI

运行 ComfyUI

使用 `comfy generate` 直接调用合作节点（Beta）

前置条件

您的首次生成

热门模型

发现模型

使用参考图片进行编辑

视频生成（异步任务）

通过 JSON 输出编写脚本

管理自定义节点

管理模型

贡献

数据分析