API Error 524 Timeout 怎么解决？Claude / Codex 长请求超时原因
https://api1.link-ai.cc/v1 改成 https://api2.link-ai.cc/v1。524 不等于 Key 错，不等于一定扣费。
快速解决：切换 Base URL
将 https://api1.link-ai.cc/v1
改为 https://api2.link-ai.cc/v1
为什么 api1 会 524？
api1 经过 Cloudflare，Cloudflare 最多等待 120 秒。超过 120 秒即返回 524。
为什么 524 不等于扣费？
524 表示超时，如果没有有效输出（completion_tokens=0，无文本），则不应产生最终扣费。
和 Link-AI 有什么关系？
Link-AI 是什么？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型的接入服务。
- api1：普通 API 请求、网页端、登录、注册、充值、支付回调
- api2：Claude Opus、Claude Code、Codex、长上下文、长输出、Agent 长任务直连通道
遇到 524 时，将 Base URL 切换到 api2 即可解决。如果担心扣费，使用 API 扣费检测工具验证。
524 是客户端问题还是服务端问题？
都不是。
524 是 Cloudflare 的超时机制导致的，跟你的网络、Key、模型都没有直接关系。
- 524 ≠ 你的网络有问题
- 524 ≠ Key 错了（Key 有误会报 401/403）
- 524 ≠ 模型不支持
- 524 ≠ 服务器宕机（源站正常，只是响应慢）
解决方法：切换到不经过 Cloudflare 的直连通道（api2.link-ai.cc）。
为什么 api1 会遇到 524？
524 超时是 Cloudflare 的专属错误代码，与源站本身无关。在 Link-AI 架构中：
api1 通道：请求经过 Cloudflare，Cloudflare 最多等待 120 秒。如果源站在 120 秒内没有完成响应，Cloudflare 会关闭连接并返回 524 Origin Timeout。
api2 通道：直连源站，不经过 Cloudflare，等待时间由源站控制（1800 秒）。长请求不会被中断。
容易触发 524 的场景
- Claude Opus 处理复杂逻辑任务，输出长度超过一定阈值
- Codex 复杂代码重构或生成大量代码
- Claude Code 长任务（多轮对话、复杂 Agent 任务）
- 长上下文（100k+ tokens）的推理任务
- Streaming 模式被禁用时的长输出
- 上游渠道响应缓慢（如模型冷启动）
api1 和 api2 有什么区别？
| 特性 | api1.link-ai.cc | api2.link-ai.cc（推荐长请求） |
|---|---|---|
| 网络路径 | Cloudflare 代理 | 直连（无 Cloudflare） |
| 超时限制 | 120 秒（Cloudflare 限制） | 1800 秒（源站控制） |
| 适用场景 | 普通请求、网页端、充值、支付回调 | Claude Opus、Codex、Claude Code、长上下文、长输出 |
| CDN 加速 | 有（Cloudflare） | 无 |
| 扣费 | 共享余额 | 共享余额 |
524、503、504、timeout 有什么区别？
| 错误代码 | 含义 | 原因 | 解决方法 |
|---|---|---|---|
| 524 | Cloudflare Origin Timeout | 源站响应慢，超过 120 秒 | 切换 api2 |
| 503 | Service Unavailable | 上游渠道不可用或过载 | 稍后重试，或切换渠道 |
| 504 | Gateway Timeout | 代理层（nginx/网关）超时 | 检查网络，或等上游恢复 |
| timeout | 请求超时 | 客户端超时设置过短，或网络问题 | 增加客户端超时时间 |
| 401/403 | 认证/授权失败 | Key 错误、过期或无权限 | 重新获取 API Key |
Claude Code / Codex 长请求推荐配置
将 Base URL 从 api1.link-ai.cc/v1 改为 api2.link-ai.cc/v1，即可绕过 Cloudflare 的 120 秒超时限制。
Claude Code
export ANTHROPIC_BASE_URL="https://api2.link-ai.cc" export ANTHROPIC_AUTH_TOKEN="sk-你的key"
Codex CLI
model = "gpt-5.5" openai_base_url = "https://api2.link-ai.cc/v1"
Cherry Studio / 其他客户端
Base URL: https://api2.link-ai.cc/v1 API Key: sk-你的key
524 是否等于 Key 错了？
不等于。
524 是超时错误，与 Key 正确与否无关。如果 Key 本身有误，会报 401 或 403，而不是 524。
如果看到错误信息里有 api.openai.com 且报错是 invalid_api_key，说明配置没有生效，Codex CLI 没有读取自定义 Base URL，跟 Key 本身是否正确无关。
524 是否等于一定扣费？
不等于。
524 表示超时，如果请求没有产生有效输出（completion_tokens = 0，无文本，无 tool_call），则不应产生最终扣费。
如果请求已经部分完成，则可能已消耗部分额度。
建议使用扣费检测工具验证 raw quota 变化，判断扣费是否异常。
检查清单：遇到 524 时逐一检查
- Base URL 是否使用了
api2.link-ai.cc/v1？ max_tokens是否设置过大？尝试减少到4096或8192，分段请求。- 是否启用了
stream: true？流式输出可以避免长时间等待无响应而被中断。 - 上游渠道是否正常？可以查看 控制台公告 或系统状态。
- 是否出现了
503 Service Unavailable或524 Origin Timeout？ - API Key 是否有效？余额是否充足？
- 令牌是否有目标模型的调用权限？
- 请求是否有
record consume log（在 API 响应中检查 usage 字段）？ - raw quota 是否有变化？可以用 扣费检测工具 验证。
- 是否出现空回复（无文本、无 tool_call）？
常见问题
524 超时是 Cloudflare 的错误代码，表示请求已到达源站，但源站在 Cloudflare 的 120 秒等待窗口内没有完整返回响应。长请求（Claude Opus、复杂代码生成）常触发此错误。
都不是。524 是 Cloudflare 的超时机制导致的，跟你的网络、Key、模型都没有直接关系。解决方法是切换到不经过 Cloudflare 的直连通道（如 api2.link-ai.cc）。
Claude Opus 和 Codex 的长输出任务生成时间常超过 Cloudflare 的 120 秒等待限制。此时请求虽然已经到达源站，但 Cloudflare 会在 120 秒后主动关闭连接，返回 524 超时。
将 Base URL 从 api1.link-ai.cc/v1 切换为 api2.link-ai.cc/v1。api2 直连通道不经过 Cloudflare，等待时间由源站控制，不受 120 秒限制。
不等于。524 是超时错误，与 Key 正确与否无关。如果 Key 本身有误，会报 401 或 403，而不是 524。
不一定。524 表示请求超时，如果没有产生有效输出（无 completion_tokens、无文本），则不应产生最终扣费。建议用扣费检测工具验证 raw quota 变化。
524：Cloudflare 超时，请求到达源站但响应慢。503：上游渠道不可用。504：网关超时，代理层超时。timeout：客户端或上游超时，原因多样。处理方式不同：524 换 api2；503 等渠道恢复；timeout 调整超时设置。
可以尝试：1) 减少 max_tokens（分段请求）；2) 启用 stream: true（流式输出）；3) 简化 prompt。根本解决方案是切换 api2 直连通道。