PopNowAPI 文件
整合
主要內容

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 輸出資料夾中的位置

常見設定

目標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 的環境中在同一個終端機或 .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、CLI 與開源工具。

支援 ComfyUI Desktop 與可攜版嗎?

支援。只要能安裝自訂節點的地方都能用:可攜版、Desktop 與自架的伺服器。

需要 GPU 嗎?

不需要。生成在 PopNow 的伺服器上進行;你的電腦只負責送出請求並接收檔案。

要怎麼把影片影格放回節點圖中?

節點會把影片存進 ComfyUI 的輸出資料夾,並回傳它的路徑。用影片載入節點載入它,就能取得影格。

本頁內容