更新日志

按时间倒序列出影响你已有代码的变更。不需要任何操作的新增功能也会列出，方便了解又多了哪些可能。日期均为 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），浏览器或移动应用调用 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（价格已变化），且不冻结任何积分；重新报价并向用户展示新价格即可。
• 取整。 任务仍按整积分向上取整收费，但一个整积分现在只有原来的十分之一，所以取整造成的差额也缩小为原来的十分之一。
• 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 设置指南、Agent 技能、附示例的 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 种语言，并附带供工具和 Agent 使用的 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 只负责读取。见素材库。

相关内容