超时通常表现为：客户端长时间无首包、报 timeout / response header timeout，或最终收到 503 与冷却相关错误。不一定是 Token 错误。
常见原因
-
上游推理较长或短暂拥塞
长 reasoning / 大上下文更容易触发首包等待。平台对连续失败有分级冷却，见 服务冷却与重试。 -
本地网络或代理
- 国内用户优先试
https://relay.4aicode.net - 海外用户优先试
https://relay.4aicode.com - 公司代理、错误系统代理、抓包工具可能导致 TLS 或连接挂起
- 国内用户优先试
-
客户端超时阈值过短
部分 IDE / SDK 默认超时短于长任务所需时间，可在客户端侧适当提高，并启用有限次退避重试。 -
并行任务过多
多开 Codex / Claude Code / 批量任务会排队或触发繁忙；先降到 1～3 路并行。
处理步骤
- 换线路重试一次（
.net↔.com），Token 通用。 - 单请求复现：用最小 prompt 调用同一模型，确认是否仍超时。
- 查看 服务公告 是否有维护。
- 若返回
no_account_available/ cooling down，按提示等待后重试，勿密集连点。 - 持续超过约 15 分钟仍失败：联系 support@4aicode.com，提供时间、模型、工具名与
trace_id（不要发送 Token）。