guides

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

PoYo Team
3 min read
Share:

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


Q1. 新的快速模型快到自己先撞上 429——尤其是在最高推理和并行 Codex 会话下。

开发者在抱怨什么: GPT-6.1 Terra 作为更快、更便宜的 computer-use 档位上线后,开发者立刻在 Terra / fast-mode 以及最高推理下撞上 HTTP 429,而同一条提示在 Sol 上没有。有几篇帖子指出,429 时消耗的 token 为零,这意味着并发或速率闸门在计量之前就触发了。并行的 Codex 会话轮询同一把 Key,把情况弄得更糟。

PoYo 如何回应: 我们的错误码页面给 429 一个含义——rate_limit_error——和一项建议动作:等待后再重试,或把请求排队。入门公布的默认生成限制是:每个账户每 10 秒最多 20 个新的生成请求。超出该限制的请求会得到 HTTP 429,并且不会进入队列。对话和媒体模型共用一把 PoYo Key,并列在 llms.txt 里,因此切换模型是改一个 model 字符串,而不是重新接入一家供应商。如果持续撞上 429,文档说可以联系支持申请更高限额;审批会谨慎处理。

文档写明供应商之间没有自动故障转移。请在客户端自己做回退。入门还说,PoYo 的「整体稳定性可能略低于官方供应商」。


Q2. 我的「429」其实是消费上限——账单错误穿着速率限制的衣服。

开发者在抱怨什么: 有一篇帖子概括得很清楚:HTTP 429 不是一种失败模式。在 Anthropic 上,它可以是速率限制、加速限制,也可以是消费上限。消费上限触发的 429 往往没有 Retry-After,一直等下去没有用。团队仍在把一次硬性的账单停用当成限流。

PoYo 如何回应: PoYo 在错误码表里把这两种情况分开:

状态码error.type含义 / 怎么做
402insufficient_credits_error余额已经用完。请充值。重试没有用。
429rate_limit_error撞上了速率限制。请等待或排队。
500 / 502 / 503internal_error / upstream_error / service_error用指数退避重试。

计费本身是预付积分:首页写明一次性购买,没有周期性订阅,积分永不过期。需要实时数字时,轮询 GET /api/user/balance 读取 credits_amount(用户余额)。错误码页的提示写得很明确:监控积分,避免在关键工作中撞上 402。


Q3. 我的智能体 SDK 把速率限制窗口烧得比对话快大约 1.7 倍——而且 N 个智能体仍然共用一个上限。

开发者在抱怨什么: Anthropic 承认 Agents SDK 里有一个缺陷:从对话切到智能体模式时,消耗 Claude 5 小时速率限制的速度大约比预期快 1.7 倍。另外,开发者指出 worktree 解决了文件冲突,但十个智能体仍然共用一个数据库和同一个 API 速率限制,于是并行的 harness 会在同一把 Key 上互相绊倒。

PoYo 如何回应: PoYo 上的生成按异步来设计,因此长任务不绑在单次网关超时上。入门和 API 概览写的是:提交任务,保存 task_id,然后轮询状态或接收 webhook。生产负载上,文档更建议使用带签名的 webhook,而不是频繁轮询。遇到 429,等待或排队(错误码)。默认生成限制仍然是每个账户每 10 秒 20 个新请求,超出的请求会被拒绝,并且不会进入队列。

为了不让一个失控的智能体耗尽整个账户,请使用 API Key 页面和入门里写明的控制:按 Key 的每小时、每日和总量用量上限。图像、视频、音乐、对话和 3D 都在一把统一 API Key 后面(llms.txt、首页)。

文档写明供应商之间没有自动故障转移。客户端必须自己处理 429 / 5xx,并选择下一个模型或重试路径。


Q4. 又一家 SaaS 拿到了我的 AI Key——供应商说未经授权的消费不可退款。

开发者在抱怨什么: 一位开发者报告,一把被攻破的 Anthropic API Key 产生了 105.94 美元的未经授权用量;支持(经由一个 AI 智能体)表示已消耗的用量不可退款,并关闭了升级。同一个 48 小时窗口里,OpenCode Console / Railway 一类的安全事件反复出现,被拿走的是存着的 OpenAI、Anthropic 和 Google Key。先轮换,再设一个硬性消费天花板。

PoYo 如何回应: 先轮换。泄露的密钥仍然是泄露的密钥。之后,文档列出了可以限制被盗 PoYo Key 能做什么的控制:

  • IP 白名单。 可以只允许已批准的服务器 IP 使用某把 Key。从环境变量里复制出去的 Key,在攻击者的机器上不能使用。见 API Key 页面和入门。
  • 按 Key 的用量上限(每小时、每日和总量),给单把 Key 在你发现之前设一个硬天花板。
  • 按终端用户拦截。 发送 X-End-User-ID 头之后,可以拦截该 Key 上的某一个滥用调用方,而不必轮换整把 Key。被拦截的 ID 会返回 HTTP 403,错误为 end_user_blocked。见终端用户标识。

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


Q5. AI 客户端应该知道什么时候不该重试——视频重试可能悄悄把账单翻倍。

开发者在抱怨什么: 重试对临时故障有用,但不是万能的。请求格式错误、凭证无效,或账户用不了某个模型时,重复同一个调用只会增加压力。在视频 API 上,同一主题表现为:点了重试,就可能再创建一个会计费的任务。

PoYo 如何回应: 在错误码里把错误和动作对上:

  • 402 insufficient_credits_error → 充值。不要重试。
  • 429 rate_limit_error → 等待或排队。
  • 500 / 502 / 503 → 指数退避。
  • 401 → 修正 Key。用同一把无效凭证重试没有用(入门)。

入门还警告:把每一次提交重试都视为可能是新的付费工作;重新提交之前,先确认原来的请求有没有创建任务。对媒体,llms.txt 和首页写明失败的任务不计费,计费按成功产出、按模型计价。等待时优先使用 callback_url / webhook,而不是猛烈轮询状态,以免把负载放大(API 概览)。


Q6. API 定价和订阅比起来仍然贵得离谱——而且智能体烧完之前,我看不到实时余额。

开发者在抱怨什么: 有一条回复说得很直白:订阅感觉是被补贴的,但 OpenAI 和 Anthropic 的 API 定价「贵得离谱」。同一窗口里的其他帖子在问,人们是否知道一条多智能体提示按 API 费率要花多少,并提醒开发者:ChatGPT / Codex 的订阅计量和 API 计量并不互通。

PoYo 如何回应: 文档里有三块内容和这条抱怨对得上:

  1. 预付积分,没有订阅计量。 首页描述的是按积分计价:一次性购买,没有周期性订阅,积分永不过期。成功的生成才付费;失败的任务不计费(llms.txt)。
  2. 一把 Key,一份余额。 对话和媒体共用一个 PoYo 账户。轮询 GET /api/user/balance 读取 credits_amount(用户余额)。
  3. 公开的按模型价格。 当前价格在每个模型页面 / https://poyo.ai/models/<id>/llms.txt,以及目录索引(llms.txt)里。提交付费工作之前先看这些页面,不要凭记忆推断美元金额。任务历史(入门里有说明)可以事后查看模型、输入和状态。

Q7. 我的「服务端函数」/ Telegram 机器人任何人都能调用——Key 就放在 curl 找得到的地方。

开发者在抱怨什么: 实操向的安全帖子不断出现:限制 API Key,并设置每日配额;不要把供应商 Key 贴进对话界面或 Telegram 智能体;一把放在可被调用的服务端函数里、又没有按用户速率限制和消费天花板的 Key,对找到这个 URL 的人来说就是一张信用卡。

PoYo 如何回应: 入门写得很明确:不要在前端代码里暴露 API Key(浏览器、移动应用、公开仓库)。把 Key 当作密钥,留在你的服务器上,并使用文档里已经写明的生产 Key 控制:

  • 在 API Key 页面设置 IP 白名单和按 Key 的每小时 / 每日 / 总量上限。
  • 要求 X-End-User-ID,然后用 HTTP 403 end_user_blocked 拦截滥用调用方,不必轮换整把 Key(终端用户标识)。
  • 上生产之前,明确处理 401、402 和 429(入门、错误码)。

速查

抱怨PoYo 写在哪里
快速上线时 Terra / Codex 的 429错误码 · 入门:速率限制 · llms.txt
伪装成 429 的消费上限错误码:402 与 429 · 首页:积分 · 余额 API
Agent SDK / 并行智能体烧同一个上限入门:异步与 429 · API 概览 · API Key 上限
Key 泄露与未经授权的消费API Key 页面 · 入门 · X-End-User-ID
盲目重试 / 视频任务被做两次错误码 · 入门:重试即可能是新的付费工作 · llms.txt:失败不计费
API 比订阅贵 / 余额不透明首页:积分 · 余额 API · llms.txt 定价
Key 留在机器人 / 对话界面 / 服务端函数入门:不要暴露 Key · API Key 页面 · X-End-User-ID
Share: