> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sub2api.ruilinlu.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 上游服务不可用排查指南

> 上游服务不可用意味着 OpenAI、Anthropic 等上游出现故障，了解应对方法。

Sub2API 作为 AI API Gateway，将请求转发至 OpenAI、Anthropic、Google 和 xAI 等上游供应商。当这些上游服务出现中断、维护或模型下线时，你可能会收到服务不可用的错误。本文将帮助你判断是否为上游故障，并提供应对策略。

## 常见原因

<Accordion title="第三方供应商服务中断">
  OpenAI、Anthropic、Google 或 xAI 本身可能出现区域级或全球级服务中断。这是 Sub2API 无法控制的外部因素。
</Accordion>

<Accordion title="模型已下线或弃用">
  上游供应商可能会停止维护某些旧版本模型，并引导用户迁移至新版本。请求已弃用的模型 ID 将返回不可用错误。
</Accordion>

<Accordion title="供应商计划性维护">
  上游供应商偶尔会进行计划性维护，期间部分模型可能不可用。
</Accordion>

## 解决方法

<Steps>
  <Step title="尝试切换模型">
    如果一个模型的请求持续失败，尝试使用同系列的其他模型。例如，若 GPT-4 不可用，可切换至 GPT-4o 或 GPT-3.5-turbo。了解如何选择模型请参考 [模型选择指南](/models/how-to-choose)。
  </Step>

  <Step title="等待后重试">
    如果是上游临时中断，通常几分钟至数小时内可恢复。建议实现带退避的重试逻辑，并在多次失败后切换至备选模型。
  </Step>

  <Step title="关注上游状态页">
    可以查看各供应商的官方状态页面，确认是否为已知故障：

    * OpenAI 状态页
    * Anthropic 状态页
    * Google AI 状态页
    * xAI 状态页
  </Step>
</Steps>

## 重要声明

<Note>
  Sub2API 作为 API Gateway，无法保证上游供应商的可用性。上游服务的稳定性受各供应商自身影响，具体条款请参见 Sub2API 服务协议。
</Note>

## 有效预防

* 在应用中实现多模型降级策略，当首选模型不可用时自动切换备选模型
* 监控错误类型，区分上游不可用错误与其他调用错误
* 订阅上游供应商的状态通知，提前获取维护公告