跳转到内容

错误排查与状态码

查看球球 Token API 的常见报错。了解如何区分上游拥挤与本地配置问题,并快速解决。

在调用接口时,您可能会遇到一些状态码报错。本页面对最常出现的几类错误进行了整理与解答,帮助您快速定位问题。

1. 上游模型拥挤与限流 (Upstream Jitters)

标题“1. 上游模型拥挤与限流 (Upstream Jitters)”的锚点

这部分报错完全源自上游官方(如 OpenAI)的服务器压力或并发限制。系统没有对您做任何拦截。

HTTP 502Our servers are currently overloaded. Please try again later.

上游 (OpenAI) 限制

原因分析:这是 OpenAI 官方服务器目前处于高负载(算力短缺)的直接返回。通常在晚高峰或复杂长文本处理时极易出现。

解决方案:

  • 直接重试:这是最有效的解决方式。只需在客户端点击“重试”按钮,或直接发送文本 继续 让模型接着输出即可。
  • 不要惊慌:这不是您的配置问题,也并非账号欠费,仅仅是官方卡顿。

HTTP 429Concurrency limit exceeded for account, please retry later

上游 (OpenAI) 限制

原因分析:您当前请求使用的上游底层并发池(Concurrency)瞬时打满了。当同一时刻有大量用户请求该模型时,官方会实施排队或限流策略。

解决方案:

  • 同上,等待 3-5 秒后重新点击发送。通常下一次请求分配到空闲并发线程即可正常响应。

ErrorSelected model is at capacity. Please try a different model.

上游 (OpenAI) 限制

原因分析:该特定模型(例如 gpt-5.5)在官方机房的算力容量已达上限,官方暂时拒绝了新任务的分发。

解决方案:

  • 继续重试:多试几次有概率挤入。
  • 切换模型:如非必须,可暂时在模型列表选择其他变体进行过渡。

2. 网络与链路中断 (Network & Stream)

标题“2. 网络与链路中断 (Network & Stream)”的锚点

这类报错通常是因为数据在传输过程中,网络链路发生异常断开导致。

HTTP 504stream error: stream disconnected before completion

网络链路中断

原因分析:在使用流式输出(打字机效果)时,客户端与网关之间的 TCP 长连接断开。可能由于您本地的网络波动、梯子断流、或经过的国际路由不稳定导致。

解决方案:

  • 切换接入线路:使用 CC Switch 快速切换接入线路。切换后必须重启 Codex 或新开会话,新的线路配置才会生效。
  • 配置代理:使用直连路线时不要叠加代理;只有选择国际线路时,才需要根据您的网络环境配置代理。

3. 本地配置错误 (Configuration Errors)

标题“3. 本地配置错误 (Configuration Errors)”的锚点

如果您收到了 401 相关的错误,请检查您的令牌与客户端配置。

HTTP 401Invalid API Key provided / Unauthorized

客户端请求

原因分析:鉴权失败。

解决方案:

  1. 检查 API Key(sk-...)是否复制完整,前后是否有多余的空格。
  2. 确认该 Token 是否在后台被禁用或已达到额度上限。
  3. 确认您的余额是否充足。