> ## 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.

# 模型不存在或不可用排查

> 模型返回不存在或不可用错误时，检查模型名称拼写、账户权限与上游可用性。

当你收到类似 `Model not found`、`Model unavailable` 或 `The model does not exist` 的错误时，说明 Sub2API 无法处理你对该模型的请求。这通常不是系统全局故障，而是由模型名称拼写、权限配置或上游状态导致的。本文将帮助你逐一排查。

## 常见原因

<Accordion title="模型名称拼写错误">
  模型 ID 必须严格拼写，包括大小写和连字符。例如 `gpt-4o` 与 `gpt-4` 是不同的模型，`claude-3-opus-20240229` 与 `claude-3-opus` 也可能不被视为等价。常见的拼写错误包括：多余的空格、使用中文标点、大小写不一致等。
</Accordion>

<Accordion title="模型在账户中不可用">
  部分模型需要额外权限或属于特定套餐。如果你的账户未开通对应模型的访问权限，请求会返回不可用错误。

  可参考资料：

  * [OpenAI 模型列表](/models/openai)
  * [Claude 模型列表](/models/claude)
</Accordion>

<Accordion title="上游模型已弃用">
  OpenAI、Anthropic 等供应商会定期弃用旧版本模型。如果你使用的模型 ID 已停止服务，Sub2API 会无法完成代理请求。
</Accordion>

## 解决方法

<Steps>
  <Step title="核对模型名称拼写">
    在控制台或文档中复制准确的模型 ID，避免手动输入。例如确认使用的是 `gpt-4o` 而不是 `gpt-4` 或 `GPT-4-O`。
  </Step>

  <Step title="尝试使用替代模型">
    如果目标模型不可用，尝试切换到功能相近的替代方案。例如：

    * GPT-4 不可用 -> 尝试 GPT-4o 或 GPT-4o mini
    * Claude Opus 不可用 -> 尝试 Claude Sonnet 或 Haiku

    了解如何根据场景选择模型，请参考 [模型选择指南](/models/how-to-choose)。
  </Step>

  <Step title="确认账户模型权限">
    登录 [Sub2API 控制台](https://sub2api.ruilinlu.com)，查看你的账户已开通哪些模型。如目标模型不在列表中，可能需要联系管理员开通权限。
  </Step>

  <Step title="排除上游模型下线">
    如果多个账户在同一时间都出现同一模型的不可用错误，可能是上游供应商已弃用该模型。此时应迁移至新版模型，并关注供应商公告。
  </Step>
</Steps>

## 有效预防

* 将模型 ID 以常量形式维护在配置文件中，避免散落在代码中导致拼写错误
* 在应用中实现模型降级逻辑：当首选模型不可用时自动尝试备选模型
* 定期查看 [模型选择指南](/models/how-to-choose) 和供应商公告，了解模型生命周期变化

如需了解 Sub2API 支持的全部模型，请参考 [OpenAI 模型列表](/models/openai) 和 [Claude 模型列表](/models/claude)。