常见问题

Key、余额、模型、超时和限流问题。

⚠️常见错误代码对照表

下面是常见错误码和报错提示的快速判断。遇到问题时，优先提供报错截图、request_id、模型、时间和使用的软件。

快速判断

400 / Bad Request

请求格式或参数有问题。

常见原因：JSON 格式错误、字段名写错、字段不支持、请求体没有完整传到服务端、客户端中途断开、请求体过大或上传太慢。

如果提示 Failed to read request body，一般是请求体没完整传到服务端。常见原因是网络断流、代理/VPN/梯子不稳定、客户端中断、请求体过大、上传太慢。

401 / Unauthorized

API Key 错误、没带 Key、Key 被禁用，或 Bearer 格式不对。

请检查：

• 是否填了正确的 API Key
• 是否带了 Authorization: Bearer sk-...
• Key 是否被禁用
• Base URL 是否填错

403 / Forbidden

没有权限或请求被拒绝。

常见原因：用户余额不足、分组权限失效、内容审计命中、上游账号权限异常、上游账号余额不足、上游账号失效、IP 或地区被上游拒绝。

如果之前能用，突然出现大量 403，一般优先检查账号池和上游账号状态。

404 / Not Found

路径写错，或请求的模型在当前分组/号池里不存在。

常见原因：Base URL 填错、接口路径写错、模型名称写错、当前分组不支持该模型。

413 / Payload Too Large

请求体太大。

常见原因：文字太多、图片太大、文件太大、上下文太长，超过当前域名、网关或模型限制。

解决办法：压缩提示词、删除无关历史、拆分文件、减少图片、降低单次请求量。遇到 too_big、payload too large、maximum context length 这类提示，也按请求体过大处理。

429 / Rate Limit

触发限流。

常见原因：用户并发太高、待处理请求太多、API Key 独立额度用完、上游账号额度打满、上游账号冷却、客户端连续快速重试。

如果提示 API key 额度已用完，说明当前 API Key 独立额度耗尽，不一定是账户余额没钱。

如果提示 The usage limit has been reached，一般是上游账号额度达到限制，不代表客户余额没了。频繁出现说明该模型池可用账号不足或很多账号接近额度上限。

如果提示 Upstream rate limit exceeded. Please retry later.，说明上游触发限流，建议稍等再试，或者换模型/换分组。

流式断开 / Stream Error

如果出现下面这类报错：

• stream disconnected before completion
• stream closed before response.completed
• responses stream error
• connection reset by peer
• context canceled
• client connection lost
• server sent GOAWAY
• http2: server sent GOAWAY
• stream ended before a terminal event

通常是流式连接中途断了。

常见原因：客户端网络不稳、代理/VPN/梯子不稳定、节点切换、链路丢包、客户端主动取消、上游长时间无响应，或者大上下文导致连接时间太长。

建议：重启客户端，换稳定节点或关闭不稳定代理，降低单次上下文，开启流式，避免连续快速重试。

负载过高 / 请求太大

如果提示负载过高、服务繁忙、网关超时、请求超时，一般不是 Key 错，而是当前请求太重或链路太慢。

常见原因：上下文太长、文件太大、一次性输入太多、模型推理时间过长、连续重试太快、服务或上游当前压力较高。

建议：压缩上下文，删除无关历史，拆分任务，减少图片和大文件，开启流式输出，失败后等待 30-60 秒再重试。

500 / Server Error

服务内部错误。

可能是上游官方异常，也可能是中转服务内部异常，需要看 request_id。偶发可以重试，持续出现请带 request_id 联系管理员。

如果 Codex 客户端触发自动审核异常，可以尝试关闭自动审核，或设置 review_model="gpt-5.4" 后再试。

502 / Bad Gateway

上游、代理或网关返回异常。

常见原因：上游账号不可用、号池空了、死号较多、模型上下文超限、参数不支持、代理断流、上游返回坏响应、后端临时异常。

如果之前正常，突然大量 502，一般优先检查号池可用账号、代理节点和后端服务状态。

503 / Service Unavailable

当前服务不可用。

常见原因：当前分组无可用账号、号池暂时不可调度、服务繁忙、路由器找不到可用渠道、分组只允许特定客户端。

如果提示 no available accounts、no auth available、model channel not available，通常是对应模型池没有可调度账号。

504 / Gateway Timeout

网关等待上游超时。

常见原因：模型响应太慢、大上下文、上游卡住、代理链路慢。

建议减少上下文、开启流式、稍后重试。

522 / Cloudflare Connection Timeout

Cloudflare 连不上源站。

常见原因：源站宕机、防火墙挡住、Caddy/端口不可达、服务器过载导致无法建立连接。

这是 Cloudflare 到服务器之间的问题，不是客户 Key 写错。

524 / Cloudflare Timeout

Cloudflare 已经连到源站，但源站太久没响应。

常见原因：长请求、大上下文、非流式请求、上游响应慢、sub2api/Caddy 忙不过来。

如果长上下文或大任务频繁 524，建议开启流式、压缩上下文、拆分任务，或换专属/VIP 域名。

Cloudflare 相关错误

如果错误里带 cf-ray，说明请求经过了 Cloudflare。

常见判断：

• 522：Cloudflare 连不上源站
• 524：Cloudflare 连上了源站，但源站响应太久
• 413：请求体超过限制
• 429：Cloudflare、本站或上游任一层触发限流

Codex / Claude Code / 客户端建议

如果是 Codex、Claude Code、Cursor、NewAPI 等客户端报错，先确认：

• Base URL 是否正确
• API Key 是否正确
• 模型名称是否在当前分组支持
• 是否开启流式
• 是否走了不稳定代理/VPN/梯子
• 是否一次性发送了超大上下文或大文件
• 是否连续快速重试

如果使用代理后频繁断流，可以换更稳定节点、打开 TUN 模式或关闭不稳定代理后再试。

反馈时请提供

• 报错截图
• request_id
• 使用模型
• 大概时间
• 使用的软件或客户端
• 是否使用代理/VPN/梯子