这个错误与代码无关:密钥背后的预付余额为空(或已触发每月支出上限)。以下介绍 Anthropic Console 与网关之间计费模式的差异,以及能够防止它在凌晨 2 点再次发生的告警机制。
错误
// Anthropic Console (HTTP 400):
{"type":"error","error":{"type":"invalid_request_error",
"message":"Your credit balance is too low to access the Anthropic API..."}}
// OpenAI-compatible gateways, e.g. Kunavo (HTTP 402):
{"error":{"message":"Wallet balance is too low for this request. Top up at https://kunavo.com/app/billing",
"type":"insufficient_quota","code":"insufficient_quota","param":null}}原因和解决方法一览
| 原因 | 解决方法 |
|---|---|
| 预付余额确实为零 | 充值。在 Anthropic 中:Console → Plans & billing。在 Kunavo 中:/app/billing(余额永不过期)。 |
| 自动充值已关闭(或银行卡已过期) | 启用自动充值 / 更新银行卡,避免流量高峰在无人察觉的情况下将余额耗尽。 |
| 已达到每月支出上限 | 如果支出合理,请提高或清除按密钥 / 工作区设置的上限。 |
| 使用了错误工作区的密钥 | 密钥从创建它的工作区扣款 — 一个已充值的组织不会为另一个工作区的密钥提供资金。 |
确认这是余额问题,而不是身份验证问题
401 = 密钥问题;400 “credit balance too low” / 402 insufficient_quota = 资金问题。计费错误不需要轮换密钥 — 新密钥读取的仍是同一个空钱包。
充值后,用一次低成本调用进行验证
Anthropic 和 Kunavo 的余额都会立即生效 — 无需重新部署。在重新启用 worker 前,先使用最小请求进行验证:
curl -s https://api.kunavo.com/v1/chat/completions \
-H "Authorization: Bearer $KUNAVO_API_KEY" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":8,"messages":[{"role":"user","content":"ok?"}]}'在 Claude Code 中看到这个错误?
Claude Code 在使用 Console 余额为空的 Anthropic API 密钥运行时会显示此消息——Pro 或 Max 登录则会遇到用量限制,而不会显示此消息。请为 Console 充值,或继续使用按量付费的端点:Claude Code 原生读取 ANTHROPIC_BASE_URL,因此只需修改几个环境变量即可切换。请保留四行模型配置——Claude Code 的默认模型及其 opus 和 sonnet 别名会跟随 Anthropic 的最新模型,而 sonnet 别名请求 Sonnet 5.5,这是 Kunavo 尚未提供的模型。
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5让下一次变得平淡无奇
设置低余额告警(电子邮件);如果供应商支持,还应启用自动充值并设置合理的每月上限。余额耗尽时停止计费是正确行为 — 你需要的是在撞上墙之前收到警告,而不是撞上墙之后才发现。
在 Kunavo 上:读懂 402,或让它自动充值
Kunavo 钱包返回的 402 会用机器可读的形式说明原因:error.code 为 insufficient_balance,error.balance_usd 和 error.needed_usd 给出差额,error.topup_url 和 error.auto_recharge_url 会打开已预选好解决办法的账单页——这两个链接都不会扣任何费用。开启可选的自动充值后,当余额(这里指尚未减去运行中的请求和任务所预留金额的余额)低于你设定的阈值,且充值限制(包括你设定的每月上限)允许时,钱包会从已保存的银行卡按你选择的金额充值(至少 $10)。钱包余额不足以覆盖某个请求时,Kunavo 会进行这样的充值,并在答复之前再试一次该请求;如果没有充值,或充值后仍不够,请求仍会被拒绝,所以即使开启了自动充值,也可能收到 402。这笔充值仍在处理中时,402 会带上 Retry-After:请按它给出的时间重试;没有 Retry-After 的 402 就不要再重试。
如果你通过 Kunavo 调用
Kunavo 在余额为零时会明确返回 402 insufficient_quota 并停止处理(绝不会含糊地返回 500);失败的请求不计费,活跃账户会在余额耗尽前收到低余额邮件,其中包含根据自身消耗速率计算的剩余可用时间。余额是从 $10 起的预付钱包,可在 /app/billing 充值。一次充值能使用多久,完全取决于你选择的模型;各模型的费率见 Anthropic Claude API 价格列表。
常见问题
我已经充值了 — 为什么仍然收到这个错误?
确认充值的是创建该密钥的同一个账户/工作区,并确认真正的阻塞原因不是每月支出上限。余额本身在 Anthropic 和 Kunavo 上都会立即生效。
Claude API 有免费层级吗?
没有 — Anthropic 从第一个 token 开始就会对每次 API 调用计费(Claude.ai 消费者套餐与 API 余额相互独立)。网关同样采用按量付费;Kunavo 从 $10 起充,费率低于列表价。
Claude Code 中显示“Credit balance is too low”,但我支付了 Pro,为什么?
因为 Claude Code 使用的是 API 密钥,而不是你的订阅。当设置了 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN 时,Claude Code 会向该密钥计费,并暂停使用 Pro 或 Max 登录;该密钥使用的是独立的 Console 预付余额。运行 /status 查看当前生效的凭证;取消设置该变量即可恢复使用套餐,或者为该密钥充值。
OpenClaw 显示“API provider returned a billing error” — 这是同一个问题吗?
是的。这是 OpenClaw 对模型供应商拒绝计费请求的表述:API 密钥的余额已用尽或余额不足。请为该供应商充值,或将 OpenClaw 切换到其他供应商 — 下方的相关指南会比较这些选项。