API 503 Service Unavailable 怎么办？上游异常、无渠道和失败扣费排查
503 的主要原因
- 上游渠道宕机或维护
- 渠道额度耗尽
- 渠道被禁用
- 渠道被限流
- 模型池异常
503 是否扣费？
理论上不应最终扣费（请求没到上游），但预扣费机制可能导致预扣未返还。用 raw quota 对比可以精确判断。
503 和 524 的区别
| 错误 | 含义 | 请求到哪了 | 是否应扣费 |
|---|---|---|---|
| 524 | Cloudflare 超时 | 到达了源站 | 可能有（部分完成） |
| 503 | 服务端不可用 | 没有到达上游模型 | 不应最终扣费 |
| 504 | 网关超时 | 到达了代理层 | 通常不扣 |
503 的常见原因
- 上游渠道宕机：模型提供方服务不可用，所有渠道都会返回 503
- 渠道额度耗尽：渠道当月额度用完，被渠道方限制
- 渠道被禁用：渠道在后台被禁用
- 渠道被限流：请求频率超过渠道限制
- 模型池异常：模型池内没有可用实例
- empty intermediate end_turn：上游没有产生有效回复，Claude API 的特殊标记
503 是否应该扣费？
理论上不应该。
503 表示请求没有到达上游模型服务器，没有消耗任何 token，理论上不应产生最终扣费。
但如果站点使用了预扣费机制（请求开始时先冻结额度），可能出现以下情况：
- 请求开始时预扣了额度
- 请求失败，渠道返回 503
- 预扣的额度没有在结算周期内返还
- 用户看到余额少了但没有有效输出
通过 raw quota 对比可以精确判断。请参考：API 扣费检测工具
empty intermediate end_turn 是什么？
这是 Claude API 返回的特殊标记，表示对话轮次为空（即上游没有产生有效回复）。通常由以下原因导致：
- 请求格式不被上游支持
- 模型不可用或渠道异常
- 对话轮次超出模型上下文窗口
- 系统提示词被上游拒绝
empty intermediate end_turn 不应产生有效 token 消耗，但如果预扣了额度，应在结算后返还。
遇到 503 怎么处理？
- 稍后重试（503 通常是临时性问题）
- 更换使用的模型（如 Opus 503，换 Sonnet 试试）
- 查看控制台公告，了解上游渠道状态
- 用 raw quota 验证是否有异常扣费：API 扣费检测工具
- 如果持续出现 503，联系客服反馈
- 记录错误信息、时间戳和使用的模型，供客服排查
和 Link-AI 有什么关系？
Link-AI 是 OpenAI-compatible API gateway，面向开发者提供 Claude、GPT 等模型接入服务。
- 503 是上游渠道问题，不是 Link-AI 配置问题
- 如果持续出现 503，可联系客服了解渠道状态
- Link-AI 按实际消耗计费，失败请求扣费会在审计后自动返还
- 如果担心 503 导致异常扣费，用 API 扣费检测工具验证 raw quota 变化
常见问题
503 表示上游服务不可用。常见原因：上游渠道宕机、渠道额度耗尽、渠道被禁用、模型池异常、渠道限流等。
524 是 Cloudflare 超时，请求到达了源站但响应慢；503 是服务端不可用，请求没有到达上游模型服务器，可能是渠道宕机或被限流。
理论上 503 不应产生最终扣费，因为请求没有到达上游模型。但如果站点使用了预扣费机制，可能出现预扣后未返还的情况。通过 raw quota 对比可以精确判断。
这是 Claude API 返回的特殊标记，表示对话轮次为空（即上游没有产生有效回复）。通常由请求格式不支持、模型不可用或渠道异常导致。
通过对比请求前后的 raw quota 变化来判断。如果无有效输出但 raw quota 减少，则为异常扣费。具体方法见 API 扣费检测工具页面。
503 通常是临时性问题。可以：1) 稍后重试；2) 更换使用的模型；3) 检查上游渠道状态公告；4) 如果持续出现，联系客服。