PopNowAPI 文档
集成
正文

ComfyUI 云端生成节点

通过 ComfyUI Manager 安装官方 PopNow 节点包,或使用单个节点文件,在 ComfyUI 中运行云端 AI 图片、视频和音频模型。无需 GPU,也无需下载模型;包括安装步骤、输入、价格和错误解决方法。

官方 PopNow 节点包可以把 PopNow 的每一个图片、视频和音频模型都放进 ComfyUI 的工作流里。每个节点都会把任务发送到云端、等待完成,再把结果交给下一个节点。没有任何东西会下载到你的 GPU 上,所以即使是笔记本电脑内存不够的视频模型,也能顺利运行。

节点包是 Comfy Registry 上的 popnow-comfyui,源码开源在 GitHub。它为每个模型添加一个节点,另有一个接受任意模型名称的 PopNow Generate 节点,以及一个 PopNow LoRA 节点。本页与 popnow.ai 上的 ComfyUI 页面保持一致。

四步安装

安装节点包

在 ComfyUI 中打开 Manager > Custom Nodes Manager,搜索 PopNow,点击 Install,然后重启 ComfyUI。使用 Comfy CLI 的话:

comfy node install popnow-comfyui

节点包除 ComfyUI 本身外不需要其他依赖(需要 Python 3.10 或更新版本)。如果想从源码安装,请把 popnow-comfyui 克隆到 ComfyUI/custom_nodes 中。

添加你的 API 密钥

在 API 控制台创建密钥,打开 ComfyUI 的 Settings > PopNow 并粘贴。运行使用独立的 API 美元余额,初始为 $0。请在 API 账单充值;网站积分不能支付这些运行。也可以在启动 ComfyUI 的环境中设置:

export POPNOW_API_KEY="sk-popnow-..."
python main.py

Windows 便携版请在启动 ComfyUI 的 .bat 文件中添加 set POPNOW_API_KEY=sk-popnow-...。再重启一次,让节点列表从你的账户中加载。

添加节点

双击画布,输入模型名称(seedance、kling、wan、nano banana、suno …),或者浏览 PopNow > Video / Image / Audio。PopNow Generate 可以接受 模型页中的任意模型 ID。

排队运行

如果模型需要图片输入,把 Load Image 连到图片输入口,再连接 Save Image、Save Video 或 Save Audio,然后排队运行提示词。ComfyUI 的模板浏览器中,在 popnow-comfyui 下有现成的工作流图。

单文件节点

如果你更想要一个一分钟就能读完的文件,节点包中的 PopNow Generate 节点也提供单个 Python 文件版本。把它保存为 ComfyUI 文件夹中的 custom_nodes/popnow_api.py,按上面的方法设置 POPNOW_API_KEY,然后重启 ComfyUI。它只使用 requests、Pillow、NumPy 和 PyTorch,这些 ComfyUI 本身已经自带。

节点包和这个文件二选一即可:两者添加的是同一个节点。改用节点包后,请删除 custom_nodes/popnow_api.py;已保存的工作流仍然可以运行。

输入与输出

以下是 PopNow Generate 的输入和输出,节点包与单文件版本相同。节点包中按模型生成的节点则会把每个模型自己的字段显示为下拉框、滑块和接口。

输入填写内容
model模型页中的模型 ID,例如 google/nano-banana-2.1/text-to-image 或 minimax/h3/image-to-video
prompt要生成的内容。对于不需要提示词的模型,留空即可
options模型的其他字段,以 JSON 形式填写,例如 {"resolution": "2k"} 或 {"duration_seconds": 5}。每个模型的页面都列出了这些字段
image(可选)来自其他节点的 IMAGE。它会替你上传,并放入 image_field 指定的字段
image_field图片放入哪个字段:大多数视频模型用 image_url,图片编辑用 image_urls
输出包含内容
image图片模型的结果,以 IMAGE 形式输出;视频和音频输出一个空白占位图
url签名文件链接,约 20 分钟内有效
path视频和音频:文件在 ComfyUI 输出文件夹中的保存路径

常见设置

目标modeloptionsimage_field
文生图google/nano-banana-2.1/text-to-image{"aspect_ratio": "16:9", "resolution": "1k"}—
编辑本地渲染图google/nano-banana-2.1/edit{"resolution": "2k"}image_urls
让静态图动起来minimax/h3/image-to-video{"duration_seconds": 5, "resolution": "768p"}image_url
放大一帧popnow/image-upscaler-v1/upscale{}image_url
抠出主体popnow/background-remover-v1/edit{}image_url

一种典型的混合工作流:用本地的 checkpoint 生成起始帧,用图生视频模型在云端让它动起来,然后用视频加载节点读回保存的 MP4,在本地进行放大或插帧。

节点背后的工作方式

节点是对三个 REST 调用的一层薄封装;下面是其他语言中的同样调用:

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "google/nano-banana-2.1/text-to-image", "input": {"prompt": "A lighthouse on a cliff at dusk, warm window light", "aspect_ratio": "16:9", "resolution": "1k"}}'

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=job_..." \
  -H "Authorization: Bearer $POPNOW_API_KEY"
JavaScript
const API = 'https://api.popnow.ai/api/v1';
const auth = { Authorization: `Bearer ${process.env.POPNOW_API_KEY}` };
const created = await fetch(`${API}/jobs/createTask`, {
  method: 'POST',
  headers: { ...auth, 'Content-Type': 'application/json', 'Idempotency-Key': crypto.randomUUID() },
  body: JSON.stringify({
    model: 'google/nano-banana-2.1/text-to-image',
    input: { prompt: 'A lighthouse on a cliff at dusk, warm window light', aspect_ratio: '16:9', resolution: '1k' },
  }),
}).then((r) => r.json());
console.log(created.data.taskId);

上传输入图片的三步流程见上传与下载;结果是一个 popnow://f/… 引用,只能配合你自己账户的密钥使用。

价格

每次运行都从 API 美元余额按模型正常价格扣费,节点不加价。Nano Banana 2.1 的 1K 图片每张 $0.048,MiniMax H3 的 768p 视频每 5 秒 $0.185。失败的运行不收费。各模型价格见对应页面及 API 余额与退款;准确金额请用 jobs/quote查询。

常见错误

ComfyUI 显示原因解决方法
No PopNow API key is set(节点包)在 Settings > PopNow 和环境变量中都没有密钥在 Settings > PopNow 中粘贴密钥,或设置 POPNOW_API_KEY,然后再次运行
Set POPNOW_API_KEY before starting ComfyUI(单文件)该变量不在 ComfyUI 的环境中在同一个 shell 或 .bat 文件中设置它,然后重启
PopNow 401: …密钥缺失、输错或已被撤销在 API 控制台创建新密钥
PopNow 400: …,并指出某个字段options 中有模型不接受的字段,或值超出范围查看该模型的页面;未知字段会被拒绝
PopNow 40201: …API 美元余额不足在 API 账单充值,或降低分辨率、缩短时长
PopNow failed: …模型无法完成,或拒绝了该请求没有收费;修改提示词或设置
JSONDecodeErroroptions 不是有效的 JSON使用双引号:{"resolution": "2k"}
在搜索列表中找不到节点节点包或文件未安装,或 ComfyUI 没有重启检查 Custom Nodes Manager 或 custom_nodes 文件夹,然后重启;在控制台中查找导入错误
popnow.ai 上的某个模型没有对应节点节点包在 ComfyUI 启动时根据你账户的目录生成节点列表重启 ComfyUI,或使用 PopNow Generate 并填写模型 ID

这是 ComfyUI 注册表上的官方包吗?

是的。popnow-comfyui 由 PopNow 在 Comfy Registry 上发布,因此 ComfyUI Manager 和 comfy node install popnow-comfyui 都能找到它。源码在 GitHub 上,采用 MIT 许可。本页的单文件节点就是其中的 PopNow Generate 节点,放在了一个文件里。见 SDK、命令行工具与开源工具。

支持 ComfyUI Desktop 和便携版吗?

支持。凡是能安装自定义节点的地方都能用:便携版、Desktop 和自托管服务器。

需要 GPU 吗?

不需要。生成在 PopNow 一侧完成;你的电脑只负责发送请求并接收文件。

怎样把视频帧带回工作流?

节点会把视频保存到 ComfyUI 的输出文件夹,并返回它的路径。用视频加载节点读取它,即可得到帧。

本页内容