错误码对照

先在错误响应的 error.code 或 code 中查找代码，不要只看 HTTP 状态码。

code	HTTP	含义	处理
upstream_quota_share_exceeded	429	你在相应周期的份额不足	看个人额度和重置提示；反复重发不能增加份额
upstream_quota_pool_exhausted	429	可用账号的配额耗尽	等账号恢复，管理员检查供应
upstream_quota_window_not_ready	503	窗口缺失、过期或容量不可信等	等下一轮采集；持续则请管理员查该池
upstream_quota_pool_empty	503	池没有可用的账号配置	请管理员检查绑定与同步
upstream_quota_accounting_busy	503	账本并发冲突重试后仍繁忙	短暂退避；避免立即并发重发
upstream_quota_member_missing	403	不在该池启用的成员名单中	请管理员检查成员资格

pool_exhausted 与 share_exceeded 不是一回事。上游厂商自己也可能返回 429，应结合响应来源、错误代码与请求 ID 判断。

其他常见错误

• 401：检查密钥、过期和撤销状态，不要发送上游 OAuth token 代替本站密钥。
• 模型不存在或无渠道：检查模型 ID、密钥分组、模型白名单与账号状态。
• 钱包/订阅余额不足：这是基础计费检查，与账号池剩余份额不同。
• 上游 5xx / 超时：不表示个人额度用完。保存请求 ID；工具已执行部分操作时先核对结果再重试，避免重复副作用。

反馈只提供请求 ID、时间、模型名和脱敏错误，不发送密钥或完整对话。通用排查。