文档中心阅读博客
文档中心合作伙伴指南

账号健康:授权、额度、失败、重置卡和点数

判断账号为什么暂不可供号,区分手动查询、消耗重置卡和只读点数展示。

一个“不可用”可能有多个原因

先看账号的授权、凭据、Worker、出口、额度和可用状态,不要只看一个 HTTP 数字。账号级资格与某次请求是否匹配模型、价格和私有范围仍是两层判断。

账号状态与操作入口

提示应做什么
Access Token 过期本机同步检查官方 CLI 是否续期;托管账号看系统刷新结果
Refresh Token 无效/需重新授权按该账号接入流程重新授权;重复重试无效凭据无益
需要钥匙串授权准备同步时主动授权,不要反复后台触发
Worker 或出口不可用检查 Worker 状态、Partner 在线状态和代理
额度不足/保护触发查询额度,等待窗口恢复或调整经过确认的保护设置
来源变更/被其他客户端接管核对本机登录及当前维护归属

重新授权应对同一个上游账号操作,避免把另一个账号的凭据当成“修复”。

最近失败和本机诊断

Partner 的“最近失败”帮助查看供号端错误;使用者的本地诊断解决消费端处理问题。按时间、账号和请求 ID 对齐,不要把不同阶段的 400、403 等数字当成同一个错误重复发生。

Partner 最近失败页面

如果刷新凭据失败是当前根因,先处理授权,再观察旧的上游失败状态是否随着后续请求更新。

额度查询和预计刷新

手动刷新额度是读取状态,不是补充订阅。账号授权区的“预计刷新”指访问凭据预计续期时间,不是订阅额度恢复时间;实际续期可能因离线、重试或上游状态延后。本机同步账号依赖官方 CLI 续期,Client 随后同步访问凭据。

想知道何时能再次使用额度,要看相应额度窗口的重置时间。凭据有效和额度充足是两个独立条件,刷新凭据不会补回已消耗的额度。

某些套餐或字段无法确认时,不应该把空值解释成无限额度。账号只使用套餐内能力,不会为了供号自动启用额外付费 credits。

查询重置卡与使用重置卡不同

查询查看剩余次数、卡片和到期时间;重置可能消耗一张卡,改变官方限额状态。确认要使用时再点击重置并阅读确认。

显示不具备资格、未到限额、冷却中或无卡时,按提示处理。结果未确认时先查询,暂时不要重复重置,避免重复消耗。实际权益以该账号的官方状态为准。

Codex 点数展示

点数余额是账号能力的只读展示,不等于 PrimeRouter 钱包余额。平台订阅路由不会因为显示点数就自动使用额外付费额度。

处理完成后,用可用状态、额度与后续请求确认恢复;不要以一次按钮成功提示代替真实供号验证。