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

​
常见原因

模型 ID 必须严格拼写，包括大小写和连字符。例如 gpt-4o 与 gpt-4 是不同的模型，claude-3-opus-20240229 与 claude-3-opus 也可能不被视为等价。常见的拼写错误包括：多余的空格、使用中文标点、大小写不一致等。
部分模型需要额外权限或属于特定套餐。如果你的账户未开通对应模型的访问权限，请求会返回不可用错误。可参考资料：
OpenAI、Anthropic 等供应商会定期弃用旧版本模型。如果你使用的模型 ID 已停止服务，Sub2API 会无法完成代理请求。

​
解决方法

1

核对模型名称拼写

在控制台或文档中复制准确的模型 ID，避免手动输入。例如确认使用的是 gpt-4o 而不是 gpt-4 或 GPT-4-O。
2

尝试使用替代模型

如果目标模型不可用，尝试切换到功能相近的替代方案。例如：
  • GPT-4 不可用 -> 尝试 GPT-4o 或 GPT-4o mini
  • Claude Opus 不可用 -> 尝试 Claude Sonnet 或 Haiku
了解如何根据场景选择模型，请参考 模型选择指南。
3

确认账户模型权限

登录 Sub2API 控制台，查看你的账户已开通哪些模型。如目标模型不在列表中，可能需要联系管理员开通权限。
4

排除上游模型下线

如果多个账户在同一时间都出现同一模型的不可用错误，可能是上游供应商已弃用该模型。此时应迁移至新版模型，并关注供应商公告。

​
有效预防

  • 将模型 ID 以常量形式维护在配置文件中，避免散落在代码中导致拼写错误
  • 在应用中实现模型降级逻辑：当首选模型不可用时自动尝试备选模型
  • 定期查看 模型选择指南 和供应商公告，了解模型生命周期变化
如需了解 Sub2API 支持的全部模型，请参考 OpenAI 模型列表 和 Claude 模型列表。