ComfyUI 節點:雲端生成
用官方的 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 可攜版中,請把 set POPNOW_API_KEY=sk-popnow-... 加進啟動 ComfyUI 的 .bat 檔。再重新啟動一次,節點清單才會從你的帳戶載入。
新增節點
在畫布上連按兩下,輸入模型名稱(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 輸出資料夾中的位置 |
常見設定
| 目標 | model | options | image_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"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 的環境中 | 在同一個終端機或 .bat 檔中設定,然後重新啟動 |
PopNow 401: … | 金鑰遺失、打錯或已被撤銷 | 在 API 控制台建立新的金鑰 |
PopNow 400: …,並指出某個欄位 | options 中有模型不接受的欄位,或值超出範圍 | 查看模型頁面;不認得的欄位會被拒絕 |
PopNow 40201: … | API 美元餘額不足 | 在 API 帳單儲值,或降低解析度、縮短長度 |
PopNow failed: … | 模型無法完成,或拒絕了這個請求 | 沒有收費;請修改提示詞或設定 |
JSONDecodeError | options 不是有效的 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、CLI 與開源工具。
支援 ComfyUI Desktop 與可攜版嗎?
支援。只要能安裝自訂節點的地方都能用:可攜版、Desktop 與自架的伺服器。
需要 GPU 嗎?
不需要。生成在 PopNow 的伺服器上進行;你的電腦只負責送出請求並接收檔案。
要怎麼把影片影格放回節點圖中?
節點會把影片存進 ComfyUI 的輸出資料夾,並回傳它的路徑。用影片載入節點載入它,就能取得影格。

