报错解决
错误码 model_not_found 相关服务：OpenAI
解决 OpenAI API model_not_found 模型未找到错误
调用 API 时提示 model_not_found 或 The model does not exist？本文帮你排查模型名称、API 地址和权限问题。
常见症状： model_not_foundThe model does not exist模型不存在404 model
一句话回答
model_not_found 表示你请求的模型名称不存在或无法访问。多数情况是模型名称拼写错误、该模型未在你的 API 服务中上线、或 API 地址配置错误导致模型列表不匹配。
常见原因
1. 模型名称拼写错误
不同模型的正确名称是固定的，大小写敏感：
| 模型 | 正确名称 |
|---|---|
| GPT-4o | gpt-4o |
| GPT-4o Mini | gpt-4o-mini |
| GPT-4 Turbo | gpt-4-turbo |
| Claude 4 Opus | claude-4-opus |
| Claude 4 Sonnet | claude-4-sonnet |
| Gemini 2.5 Pro | gemini-2.5-pro |
2. 模型未在该服务上线
AI 中转站支持的模型是动态更新的。如果某个模型刚发布还未接入，会返回此错误。联系技术支持确认最新模型支持列表。
3. API Base URL 配置错误
如果你在调用 GPT 模型时 Base URL 填了 Claude 的地址，模型名称和接口不匹配会报此错误。TokenCheap 统一地址是 https://api.tokencheap.space/v1。
4. API Key 权限不足
某些模型需要特定的 API Key 权限。确认你的 Key 有权访问目标模型。
解决方案
1. 核对模型名称
在代码或工具中检查模型名称是否正确，建议直接从后台复制可用的模型名称。
2. 测试模型可用性
使用 curl 快速验证：
curl https://api.tokencheap.space/v1/models \
-H "Authorization: Bearer YOUR_API_KEY"这会返回你的 Key 有权访问的全部模型列表。
3. 在工具中手动输入模型名
Dify、n8n 等工具的下拉列表可能不完整。如果列表里找不到想要的模型，尝试手动输入正确的模型名称。
4. 联系技术支持
如果你不确定模型名称或该模型是否已上线，直接联系我们确认。
快速排查清单
- 核对模型名称拼写（大小写、连字符）
- 确认该模型已在你的服务中上线
- 检查 API Base URL 是否正确
- 用 /models 接口测试可用模型列表
- 联系技术支持确认