上游服务不可用排查指南

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

常见原因

第三方供应商服务中断

OpenAI、Anthropic、Google 或 xAI 本身可能出现区域级或全球级服务中断。这是 Sub2API 无法控制的外部因素。

模型已下线或弃用

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

供应商计划性维护

上游供应商偶尔会进行计划性维护，期间部分模型可能不可用。

尝试切换模型

如果一个模型的请求持续失败，尝试使用同系列的其他模型。例如，若 GPT-4 不可用，可切换至 GPT-4o 或 GPT-3.5-turbo。了解如何选择模型请参考模型选择指南。

等待后重试

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

关注上游状态页

可以查看各供应商的官方状态页面，确认是否为已知故障：

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

⌘I