guides

2026-10-28:今天听到的 7 条 API 抱怨

PoYo Team
3 min read
Share:

以下是 2026 年 10 月 26 日至 28 日,英语开发者公开提出的抱怨。下文作了转述,并附上原帖链接。每条回答只使用 PoYo 今天公开的网站和文档,并链接到出处。文档没有写到的地方,我们会直接说明。


Q1. Claude Code 在重构做到一半时撞上用量墙——仍然没有一条干净的「回退到我的 API Key」路径。

开发者在抱怨什么: 10 月 27 日至 28 日的时间线上,Claude Code / Codex 用量上限的并排截图很多。开发者在问,订阅限额用完之后,Claude Code 能不能回退到一把 API Key(@irl_danB);有人开玩笑说,重构做到一半撞上限,是新的「忘记保存」(@automater_ai);也有人比较:一边 20 美元档位在某个技术栈上几乎没用,另一边 Plus 订阅却从不触发上限(@mozdca、@LeoZhang57)。

PoYo 如何回应: PoYo 是预付积分,不是订阅制的 5 小时或每周窗口。首页写明一次性购买积分、没有周期性订阅,积分永不过期。你为成功的生成付费;llms.txt 写明失败的任务不计费。对话和媒体共用一把 API Key、一份余额。需要实时的 credits_amount 时,轮询 GET /api/user/balance(用户余额)。

余额用完时,PoYo 返回 402 insufficient_credits_error,而不是把滚动用量窗口打扮成限流(错误码)。文档里没有「订阅 → API Key」的故障转移产品功能,因为计费本身已经是积分制。要给失控的智能体加天花板,请使用 API Key 页面上按 Key 的每小时、每日和总量用量上限(入门)。


Q2. Claude Code 的「429」是三种不同的消息——一直等下去只对其中一种有用。

开发者在抱怨什么: 一条排障讨论指出,Claude Code 会露出三种长得像 429 的失败:等到重置、过一会儿再试,或者检查 API Key。每一种需要不同的处理(@aiparabellum)。另外,开发者在问 Anthropic 智能体工具里的速率限制问题是否已经修好(@XavierDelon、@GeorgeMathew_)。

PoYo 如何回应: 我们的错误码把账单和速率限制放在不同的数字上:

状态码error.type含义 / 怎么做
401authentication_errorKey 无效或缺失。请修正凭证。不要用同一把无效 Key 重试(入门)。
402insufficient_credits_error余额已经用完。请充值。重试没有用。
429rate_limit_error速率限制。请等待或排队。
500 / 502 / 503internal_error / upstream_error / service_error指数退避。

文档写明的默认生成吞吐是每个账户每 10 秒最多 20 个新请求。超出的请求得到 HTTP 429,并且不会进入队列(入门)。集成故障排查还说:速率限制时遵守 Retry-After;在确认是否已经创建 task_id 之前,不要盲目重试一次付费提交(故障排查)。

文档写明上游供应商之间没有自动故障转移。请在你的客户端里自己做。


Q3. 我曾经贴进智能体对话的任何 API Key,现在仍留在项目日志里。

开发者在抱怨什么: 在一条关于 Claude 项目日志的讨论之后,有一条回复直接点出风险:你曾经贴进对话的任何 API Key,也都在那些日志里。在 ~/.claude/projects 里搜索 sk-,然后轮换搜出来的 Key(@wazX_7)。附近的帖子在重复同一条卫生习惯:把 AI Key 当成 root 凭证来对待(@RuntimeAI_io),不要给每个智能体一把没有终止开关的共享 Key(@RohanBhanotAI)。

PoYo 如何回应: 入门写得很直接:不要在前端代码、移动应用或公开仓库里暴露 API Key,把它当作密钥。把 Key 留在你的服务器上。发生粘贴或怀疑泄露之后:

  1. 在 API Key 页面吊销 / 轮换这把 Key。
  2. 设置 IP 白名单,使复制出去的 Key 只在已批准的服务器 IP 上可用。
  3. 设置按 Key 的每小时 / 每日 / 总量上限,给泄露一个天花板。
  4. 在生成和原生对话上发送 X-End-User-ID。可以用 HTTP 403 end_user_blocked 拦截某一个滥用调用方,而不必轮换整把 Key(终端用户标识)。

公开文档并不承诺退还因泄露 Key 而产生的用量。如果认为某把 PoYo Key 被滥用,请联系 [email protected]。


Q4. 我忘掉的聚合器 Key 仍然是智能体的钱包——一次主机入侵把闲置凭证变成了 500 步的任务。

开发者在抱怨什么: 有一篇帖子警告,一把忘掉的 OpenRouter Key 仍然是智能体的钱包:一次 Railway 风格的入侵把闲置 Key 放进了待清除名单,其中一把已经为一个 500 步的智能体任务付了钱,而在此之前仪表板显示流量为零。帖子点出的处理是:消费上限、短寿命 Key,以及不要把供应商令牌留在你已经不再看管的主机上(@neiro_go_neiro)。另一条回复把同一模式连到仍在入侵数周后吊销 Key 的供应商(@Kenz_1604)。

PoYo 如何回应: 被遗弃主机上的闲置 Key 是客户端的密钥问题。密钥一旦存在,PoYo 文档里的控制可以限制爆炸半径:

  • 按环境 / harness 分别建 Key,每把都设每小时、每日和总量用量上限(API Key 页面、入门)。
  • 为生产 Key 打开 IP 允许列表。
  • 优先使用 X-End-User-ID,这样可以拦截某一个调用方,而不必删除这把 Key(终端用户标识)。
  • 用 GET /api/user/balance 看实时余额(用户余额),并在仪表板里看任务历史(入门)。

删除不再使用的 Key。文档没有写未使用 Key 的自动过期,也没有写因入侵驱动的消费的退款 SLA。把这一点说清楚,然后轮换。


Q5. 我设了硬性的 AI 消费限额——然后有人拿到 Key,一夜之间冲了过去。

开发者在抱怨什么: 一位开发者把 AI 账单限额设成 25 美元;有人拿到 API Key,一夜跑到 55 美元(@twentyonemilll)。这个主题和更早的 OpenRouter 讨论一致:禁用不够,只有完整删除 Key 才停下消耗。10 月 28 日这个窗口仍在产生同一条抱怨:上限存在,泄露仍然造成损失。

PoYo 如何回应: 上限只有落在被攻破的那份凭证上才有用,而不是只落在仪表板的软预算上。在 PoYo:

  • 给每把生产 Key 设置按 Key 的每小时 / 每日 / 总量用量上限(入门、API Key 页面)。
  • 配合 IP 白名单,使这把 Key 在攻击者的网络上失败。
  • 多租户应用使用 X-End-User-ID 加拦截(终端用户标识)。
  • 遇到 402 就停。那表示积分已经用完(错误码)。大批量之前先轮询余额(用户余额)。

如果一把 Key 可能已经出去,请删除 / 吊销它,不要只把软告警调低。公开文档并不声称会退还泄露 Key 产生的消费。


Q6. 拿到 Google API Key 痛苦到「干脆用聚合器」成了默认选择。

开发者在抱怨什么: 一位开发者说,只有 API Key 注册流程修好之后,才会去试 Google 的模型;在那之前只用 OpenRouter(@sandipb)。附近的帖子把聚合器说成智能体的支付钱包和模型切换(@tomcritchlow),也有人仍在为了测试而同时拿着十几把供应商 Key(@sunwei57247249)。

PoYo 如何回应: PoYo 做成图像、视频、音乐、3D 和对话共用一把统一 Key(llms.txt、首页)。在 API Key 页面创建 Key。媒体走异步的 POST /api/generate/submit,再加状态查询或 webhook;对话按各模型文档使用 OpenAI 兼容、Claude Messages 或 Gemini 原生端点。切换模型是改一个 model 字符串(对话还要匹配对应的端点形态),而不是再走一遍供应商接入。

当前的输入 schema 和价格在 https://poyo.ai/models/<id>/llms.txt,也在目录索引里(llms.txt)。文档并不声称 PoYo 是各实验室官方账户的透传;文档也说整体稳定性可能略低于官方供应商(入门)。请有意识地做这个取舍。


Q7. 如果我一个月只出几条片子,59 美元的视频订阅是更贵的进门方式——重试还可能造出第二笔账单。

开发者在抱怨什么: 创作者在比较按月的视频工具套餐和按条计费的 API:如果一个月只做几条 AI 视频,59 美元的套餐可能是更贵的路径,而 API 按条计费,编码智能体也可以驱动它(@aliteqai)。相关的 API 痛点还有:成片下载要等账单结算才放行(@MariaOnchainDev),以及一直存在的担心:盲目重试会造出第二个被计费的任务。

PoYo 如何回应: PoYo 上的视频按成功产出以积分计价,逐个模型不同。视频目录见 llms.txt(Sora 2、Veo 3.1、Kling、Wan、Seedance、Hailuo 等)。流程是统一的异步 API:提交,然后轮询状态或设置 callback_url(入门、Webhook)。首页和 llms.txt 都写明失败的任务不计费。

在慢视频任务上猛按重试之前:入门警告,每一次提交重试都可能是新的付费工作。先确认原来的请求是否已经创建了 task_id。优先使用 webhook,而不是猛烈轮询。402、429 和 5xx 请按错误码表处理;不要把积分停用当成速率限制。


速查

抱怨PoYo 写在哪里
用量上限墙 / 没有订阅到 API 的故障转移首页:积分 · 余额 API · 错误码:402 · API Key 上限
429 表示三种不同的失败错误码:401 / 402 / 429 / 5xx · 入门:速率限制 · 故障排查
Key 被贴进智能体日志入门:不要暴露 Key · API Key 页面 · X-End-User-ID
主机被入侵后闲置的聚合器 KeyAPI Key 上限 · IP 白名单 · 余额与任务历史 · 吊销不用的 Key
泄露的 Key 冲破消费上限按 Key 的上限 · IP 白名单 · X-End-User-ID · 402 的处理
供应商 Key 接入痛苦 / Key 蔓延一把 PoYo Key · llms.txt 目录 · 按模型的 llms.txt
视频订阅相对按条计费,加上重试计费视频目录 · 异步提交 / 状态 · 失败不计费 · 重试等于新的付费工作
Share: