更新紀錄
PopNow AI 圖片、影片和音訊生成 API、遠端 MCP 伺服器、Webhook、計費以及影響開發者的文件變更,按日期紀錄。
按時間倒序列出影響你已有程式碼的變更。不需要任何操作的新增功能也會列出,方便了解又多了哪些可能。日期均為 UTC。
除非特別標註 需要操作,以下變更都不會破壞現有的整合。
2026-10-23
需要調整:API 改用獨立美元餘額。 API 金鑰呼叫、API-key MCP 和 Playground 執行都使用獨立的 API 美元餘額,初始為 $0。網站點數與 API 資金不能互轉,也不能相互抵用。OAuth MCP 繼續使用網站點數,模型價格不變。在 API 金鑰頁面建立金鑰,在 API 帳單儲值並查看付款紀錄。金額顯示與對帳使用既有 USD 欄位(costUsd、estimatedCostUsd、maxChargeUsd、availableUsd、heldUsd、totalUsd、totalSpend)。確認報價也使用既有美元欄位:在報價到期前,以相同請求帶上 quoteId 和 expectedCostUsd: quote.maxChargeUsd 送出。請見 API 計費及 API 餘額與退款。下方較早的條目保留當時的行為,包括原本共用點數餘額和整數點數進位。
需要調整:已儲存配方的美元確認。 API-key REST 和 MCP 配方及工作流程執行現在使用美元報價:先請求報價,再用相同輸入帶上 currency: "USD"、十進位字串 max_usd 和 quote_id 確認。舊點數上限會被拒絕。讀取和恢復執行必須使用原金鑰。新的恢復端點和 resume_recipe_run 工具用於取得報價並確認整次執行的預算,包含已花費金額及執行中已承諾的費用。帶有 unpriced_steps 的報價只涵蓋目前已計價的步驟;後續步驟要等待新報價和確認。OAuth MCP 配方執行繼續使用網站點數。請見已儲存配方。
文件補上聊天模型。 Claude、Gemini、DeepSeek、GLM、Grok 和 Kimi 都可以使用同一把 API 金鑰,透過 OpenAI Chat Completions 和 Responses(https://api.popnow.ai/v1)、Anthropic Messages 及 Gemini generateContent 呼叫,按 token 以美元計費。聊天模型頁列出基底網址、SDK 範例、串流回應、token 價格與計費方式;API 參考補上這些路由,以及先前缺少的配方、技能和代理技能端點。
文件導覽更清楚。 文件首頁現在和其他頁面使用同樣的側邊欄,側邊欄按你要做的事重新分組,每個頁面都提供全部 12 種語言。
2026-10-22
SDK 和整合已上架各套件登錄平台。 官方開源套件不再需要從 GitHub 安裝:
- Python:
pip install popnow(PyPI)。JavaScript 和 TypeScript:npm install popnow(npm,同時在 JSR 上)。命令列工具:npm install -g @popnow/cli。 - PHP:
composer require popnow/popnow(Packagist)。Go:go get github.com/popnow-ai/popnow-go。新增 Java 用戶端,ai.popnow:popnow-java已在 Maven Central 上。 - ComfyUI:節點包是 Comfy Registry 上的
popnow-comfyui。可以從 ComfyUI Manager 安裝,或執行comfy node install popnow-comfyui。單檔案節點仍然可用;兩者選其一即可。 - n8n:社群節點
n8n-nodes-popnow已在 npm 上。自託管的 n8n 可以在 Settings > Community Nodes 中安裝。它還不是認證節點,所以 n8n Cloud 仍使用 HTTP Request 工作流程。 - 另外新增:popnow-proxy(
npm install @popnow/proxy),瀏覽器或手機 App呼叫 API 時,可以把 API 金鑰留在你的伺服器上;popnow-bot 是可自託管的 Telegram 與 Discord 機器人。MCP 的 stdio 橋接透過npx -y @popnow/mcp執行。
如果你之前是從 GitHub 安裝的,可以改用套件登錄平台上的套件;匯入語句保持不變。SDK、命令列工具與開源工具頁列出了所有命令。
2026-10-21
執行你儲存的配方、工作流程和技能。 在 Studio 中儲存的配方、從畫布儲存的工作流程以及泡皮技能,現在都可以透過 API 列出並執行:GET /api/v1/recipes、POST /api/v1/recipes/{id}/run(用 maxCredits 限制價格上限)和 GET /api/v1/recipes/runs/{runId},另有 GET /api/v1/skills。MCP 新增五個對應工具:list_my_recipes、run_my_recipe、get_recipe_run、list_my_skills 和 use_my_skill。這些內容只對你和你的團隊可見。見你的配方、工作流程和技能;開發者控制台新增了「配方與技能」頁面,顯示每項內容的 ID 和可直接執行的程式碼。
2026-10-19
需要操作:1 點現在等於 $0.001,價格也更低了。 過去 1 點值 $0.01,現在值 $0.001。所有餘額、價格和點數數量都變成了原來的 10 倍,但美元價值不變。與此同時,每個模型的價格都降低了約三分之一,所以同樣的請求現在花的美元比以前少。
- 你的餘額已換算。 沒有任何損失:500 點數($5)的餘額現在是 5,000 點數($5)。你金鑰上的消費上限保持相同的美元金額,並顯示新的點數數字。
- API 欄位。
credits、maxCredits、expectedCredits、estimatedCredits、availableCredits、heldCredits、totalCredits,以及GET /api/v1/models中的credits價格,都採用新單位。美元字串(cost、maxCharge、estimatedCost、available…)的含義保持不變。如果你的程式碼透過除以 100 把點數換算成美元,請改為除以 1,000;如果儲存了點數門檻或預算,請乘以 10。 - 舊報價。 變更之前的
quoteId和expectedCredits不再匹配。createTask會回傳40901(價格已變化),且不保留任何點數;重新報價並向使用者顯示新價格即可。 - 進位。 任務仍按整點數無條件進位收費,但1 點現在是 0.1 美分,所以進位造成的差額也縮小為原來的十分之一。
- MCP。 不超過 300 點數的任務立即開始;更大的任務仍需等待使用者確認。見在 ChatGPT 和 Claude 中使用 PopNow。
- 點數包。 點數包最低 $9,可得 9,000 點數,較大的包附贈點數;現在也可以自訂金額,$10 到 $2,000,按每 $1 為 1,000 點數計算。見 popnow.ai 定價頁和點數、價格與退款。
開源 SDK 與工具。 PopNow 的開發者程式碼現已在 github.com/popnow-ai 公開,採用 MIT 授權:Python 與 JavaScript 和 TypeScript 的 SDK、命令列工具、Go 與 PHP 的用戶端、MCP 設定指南、代理技能、附範例的 OpenAPI 檔案,以及 Blender 外掛、ComfyUI 節點包 和 n8n 社群節點 的原始碼。
- 以上這些目前都還沒有上架 npm、PyPI、Packagist 或 ComfyUI Registry。請按新的 SDK、命令列工具與開源工具頁所示,從 GitHub 安裝。
- 快速入門在原生 HTTP 範例旁邊展示了 Python 和 JavaScript SDK 的寫法,原生 HTTP 範例保持不變。
2026-10-17
遠端 MCP 伺服器。 PopNow 現在在 https://api.popnow.ai/mcp 執行一個 MCP 伺服器。使用者可以把它新增到 ChatGPT 或 Claude 中,直接在聊天裡生成圖片、影片、歌曲和配音;開發者可以把它新增到 Cursor、VS Code、Claude Code 或自己的 MCP 用戶端。共十二個工具,支援 OAuth 2.1 登入或 sk-popnow- API 金鑰,點數與價格和其他管道完全相同。不超過 30 點數的任務立即開始(自 2026-10-19 起為 300 點數);更大的任務需等待使用者確認。見在 ChatGPT 和 Claude 中使用 PopNow。
- 可以在 Account settings → Devices → Connected AI apps 中檢視和移除連線。
- 使用 API 金鑰發起的呼叫會計入該金鑰的消費上限,並顯示在控制台紀錄中。
- 影片特效(Zombie Turn、Flying Car 以及特效頁面上的其他特效)可透過
apply_effect在聊天應用中使用。它們不是 REST 端點。
新文件。 點數與退款、n8n、ComfyUI 與 Blender 外掛 的整合指南、配方,以及本更新紀錄。Webhook 新增了一節,介紹如何在控制台管理帳號級端點。
點數包退款規則。 如果點數包的點數一點都沒有用過,可以在購買後 7 天內退款(歐盟和英國的消費者為 14 天);失敗的生成仍會自動退還。免費獎勵點數先於點數包被消耗,點數包則按從舊到新的順序消耗。詳情見點數、價格與退款。
popnow.ai 上的整合頁面。 n8n、ComfyUI 和配方頁面現在會在生成的程式碼旁邊展示真實輸出。
2026-10-16
PopNow API 正式開放。 圖片、影片和音訊生成統一使用一套 REST API,地址為 https://api.popnow.ai/api/v1。這裡的文件位於 popnow.ai/docs,提供 12 種語言,並附帶供工具與代理使用的 OpenAPI 檔案與 llms.txt。
- 金鑰以
sk-popnow-開頭。 前綴變更之前建立的金鑰仍然有效,無需輪替。 - 金額以點數計。(上線時 1 點 = $0.01,自 2026-10-19 起為 $0.001)
credits、maxCredits、expectedCredits、availableCredits以及其他點數欄位與美元字串並列回傳。請使用點數欄位。 - 模型 ID 的格式是
<maker>/<model>/<task>,例如google/nano-banana-2.1/text-to-image。PopNow 自家的工具使用popnow作為廠商名。 popnow://引用,用於上傳的檔案(popnow://f/…)和素材庫條目(popnow://a/…),可用於任何媒體欄位。見上傳與下載。- 聊天和文字模型不屬於公開 API。 API 只涵蓋圖片、影片和音訊生成。
Webhook 負載版本 2。 新的任務回呼會帶上 X-Webhook-Payload-Version: 2 傳送,請求內容與 recordInfo 一致。見 Webhook。
開發者控制台。 帳號級 Webhook 端點(Standard Webhooks 簽名,每個帳號最多 16 個,每個端點有獨立金鑰)、帶手動重送的送達紀錄、每個模型 API 頁面上的 Playground 執行、紀錄中的金鑰篩選,以及用量的 CSV 匯出。
提交時的內容檢查。 提示詞和輸入圖片會在任務受理前檢查。被拒絕的請求回傳 400 並附帶 data.reason,不保留也不收取任何費用。模型自身拒絕的請求仍會以 content_rejected 失敗,同樣不收費。
中文錯誤訊息。 msg 和 errorMessage 現在也會根據 Accept-Language 回傳 zh-CN 和 zh-TW 的內容,此前已支援的十種語言不變。錯誤碼保持不變。見錯誤碼。
/v1 下的 OpenAI 相容影片路由也接受 x-api-key 請求標頭中的金鑰。見 OpenAI Videos。
Blender 外掛 0.1.0。 在 Blender 4.2 或更新版本中,用你的 API 金鑰把泥塑場景算繪、製作動畫並生成貼圖。見 Blender 外掛。
2026-10-15
素材庫:角色。 角色(在網站上整理好的一組參考圖)儲存在素材庫中,可透過 GET /api/v1/assets/entities 讀取;每張圖都有自己的 popnow://a/… URI,用於生成請求。角色在網站上建立和編輯,API 只負責讀取。見素材庫。

