aimover.cc · 使用帮助

API 错误处理指南

遇到报错先别慌,按下面三步走,80% 的问题自己能解决。

遇到报错,按这三步排查

1
看错误码
400 / 429 / 524…
2
看 request_id
定位后台日志
3
按原因处理
压缩 / 重试 / 换节点 / 反馈

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

🚦 错误码快速判断

类型错误码 / 提示
客户端 / 请求问题400 401 404 413
限流 / 额度问题429 usage limit
上游 / 号池问题403 502 503
网络 / 代理不稳stream / reset / GOAWAY
Cloudflare522 524 cf-ray
请求太重压缩上下文 / 拆分任务

⚠️ 本站特别提醒

📋 错误码详解

400 Bad Request · 请求格式或参数有问题

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

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

401 Unauthorized · API Key 错误

API Key 错误、没带 Key、Key 被禁用,或 Bearer 格式不对。请检查:

403 Forbidden · 没有权限或请求被拒绝

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

如果之前能用、突然出现大量 403,一般优先检查号池和上游账号状态,联系管理员。

404 Not Found · 路径或模型不存在

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

本站当前可用模型(以后台列表为准):gpt-5.6-sol gpt-5.6-terra gpt-5.5 gpt-5.4 gpt-5.4-mini 及 Claude 系列。

413 Payload Too Large · 请求体太大

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

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

429 Rate Limit · 触发限流

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

🌊 流式断开 · 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 联系管理员。

502 Bad Gateway · 上游、代理或网关返回异常

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

如果之前正常、突然大量 502,一般优先检查号池可用账号、代理节点和后端服务状态。本站上游偶发 502,属瞬时故障,稍等重试即可。

503 Service Unavailable · 当前服务不可用

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

如果提示 no available accountsno auth availablemodel channel not available,通常是对应模型池没有可调度账号,联系管理员。

504 Gateway Timeout · 网关等待上游超时

常见原因:模型响应太慢、大上下文、上游卡住、代理链路慢。建议减少上下文、开启流式、稍后重试。

522 Cloudflare Connection Timeout

Cloudflare 连不上源站。常见原因:源站宕机、防火墙挡住、端口不可达、服务器过载无法建立连接。

这是 Cloudflare 到服务器之间的问题,不是客户 Key 写错。持续出现联系管理员。

524 Cloudflare Timeout

Cloudflare 已经连到源站,但源站太久没响应。常见原因:长请求、大上下文、非流式请求、上游响应慢。

本站明确:请开启流式输出。如果长上下文或大任务频繁 524,建议压缩上下文、拆分任务、开启流式。

☁️ Cloudflare 相关错误

如果错误里带 cf-ray,说明请求经过了 Cloudflare。常见判断:

💻 客户端使用建议

使用 Codex、Claude Code、Cursor、Chatbox、NextChat 等客户端时报错,先确认:

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

📮 反馈时请提供

  1. 报错截图(或完整报错信息)
  2. request_id(如有)
  3. 使用的模型
  4. 大概时间
  5. 使用的软件或客户端(Codex / Claude Code / Cursor / 其他)
  6. 是否使用代理/VPN/梯子

联系管理员:加 QQ 群 1104671200