报错排查 · 402 / 403

402 / 403:一个是没钱,一个是不让用

402 是余额问题,403 是权限问题。两者经常一起出现,但处理方式完全不同。

对照

状态码典型文案含义处理
402insufficient balance / insufficient_quota账户余额不足充值,1 元 = 1 美元额度
403forbidden / no permission密钥无权使用该模型换分组或换模型
403key disabled密钥被禁用控制台启用或新建密钥

关于余额的三个事实

  • 按实际用量扣费,充值后立即到账,不需要等结算;
  • 调用失败(上游无渠道、参数错误)不扣费;
  • 余额不足时会直接拒绝请求,不会「先透支再补扣」。

403 的三种来源

  1. 分组不含该模型:密钥绑定分组,分组里没有的模型一律 403 或 model not found。去 价格页 核对该分组清单;
  2. 密钥被限制:控制台里密钥的额度上限、可用模型白名单被设置过,检查这些字段;
  3. 账户状态:账号被风控或停用,控制台会显示状态,联系客服处理。
最小复现bash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"hi"}]}'

这条命令返回 402 就是余额;返回 403 且 model 是你确定存在的模型,就看分组权限。

常见问题

402 和 403 应该先看哪个?

先看响应体里的 code:insufficient_balance / insufficient_quota 是余额问题;forbidden / permission_denied 是权限问题。

充值后还是 402 怎么办?

确认充值是充到了当前密钥所属的账户,而不是另一个账号;刷新控制台页面看余额是否变化。