# OpenAI model_not_found：模型已退役，换一个模型 ID

> https://router.one/zh/openai-model-not-found 的 Markdown 镜像，供 AI 助手与爬虫使用。Router One 是 OpenAI 兼容的统一 LLM API 网关。
> 最后更新：2026-10-28

上周还正常的请求，现在返回 HTTP 404、错误码 model_not_found，先看 model 字段。按 OpenAI 的模型弃用页（2026-10-27 核对），OpenAI 已在 2026 年 10 月 23 日关停 o4-mini、o3-mini、o1、gpt-4-turbo、gpt-4 和 gpt-3.5-turbo 等模型。你的 Key、账单和网络都没变：请求里的 ID 已经不对应任何模型，重试也不会恢复。本页讲清这个报错，给出统一 LLM API 网关 Router One 对已退役 ID 的实际返回，并演示怎么查可用模型、怎么改 model 字段。

## model_not_found 是什么意思？

意思是请求里的模型 ID 不对应你这把 Key 能调用的模型。官方 OpenAI API 返回 HTTP 404，错误 type 为 invalid_request_error，code 为 model_not_found，message 里会写出你发送的 ID。ID 拼错或大小写不对也会得到同样的报错；但如果这个 ID 以前能用，2026 年 10 月 23 日之后最常见的原因就是模型退役。典型的错误体：

`response.json`

```json
{
  "error": {
    "message": "The model `o4-mini` does not exist or you do not have access to it.",
    "type": "invalid_request_error",
    "param": null,
    "code": "model_not_found"
  }
}
```

## OpenAI 在 2026 年 10 月 23 日关停了哪些模型？

OpenAI 于 2026 年 4 月 22 日公告、2026 年 10 月 23 日关停了以下模型（OpenAI 模型弃用页，2026-10-27 核对）。微调模型跟随其基础模型的关停日期。下表列出 OpenAI 给出的替代模型，以及在 Router One 上应发送的 ID：

| 已退役 ID | OpenAI 给出的替代 | Router One 模型 ID |
| --- | --- | --- |
| o4-mini | gpt-5.6-terra | openai/gpt-5.6-terra |
| gpt-3.5-turbo | gpt-5.6-terra | openai/gpt-5.6-terra |
| o3-mini | gpt-5.6-sol | openai/gpt-5.6-sol |
| o1 | gpt-5.6-sol | openai/gpt-5.6-sol |
| gpt-4-turbo | gpt-5.6-sol | openai/gpt-5.6-sol |
| gpt-4 | gpt-5.6-sol | openai/gpt-5.6-sol |

## Router One 对已退役模型返回什么？

同样是 404，而且不会替你换模型。我们在 2026-10-27 23:43:27（北京时间）实测：请求 openai/o4-mini 和 gpt-4-turbo，都返回 HTTP 404、code 为 RESOURCE_NOT_FOUND，message 如下；两个请求都没有被映射到更新的模型。修复方式与官方 API 相同：发送在线目录里的模型 ID。

`response.json`

```json
{
  "error": {
    "message": "model 'openai/o4-mini' not supported, check /v1/models for available models",
    "type": "invalid_request_error",
    "code": "RESOURCE_NOT_FOUND"
  }
}
```

## 怎么查当前能调用的模型？

用你的 Router One Key 调用 models 端点，返回的每个 id 都可以直接填进 model 字段；/models 页面在浏览器里展示同一份目录。ID 区分大小写，请原样复制。

`terminal.sh`

```bash
curl https://api.router.one/v1/models \
  -H "Authorization: Bearer sk-your-router-one-key" \
  | jq -r '.data[].id'
```

## 怎么改 model 字段？

把已退役的 ID 换成列表里的一个，请求的其余部分保持不变。用 OpenAI SDK 时（base URL 指向 Router One）只改 model 参数；用 curl 的写法如下：

`terminal.sh`

```bash
curl https://api.router.one/v1/chat/completions \
  -H "Authorization: Bearer sk-your-router-one-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-terra",
    "messages": [{"role": "user", "content": "你好"}]
  }'
```

## 旧模型 ID 还可能藏在哪里？

- 环境变量和配置文件，例如 .env 里的 MODEL 或 OPENAI_MODEL、部署平台的密钥配置、YAML 配置。
- 你自己封装的默认值或框架设置：主代码改了，它们可能还留着旧 ID。
- 备用模型列表：排在第二位的已退役 ID 只在第一个模型出错时才会报错，可能藏好几天。
- 微调模型：基础模型关停后它也会停用，需要基于当前模型重新训练。
- 部署前先搜一遍代码，例如：grep -rnE "o4-mini|o3-mini|gpt-4-turbo|gpt-3\.5-turbo" .

## 换模型之后要测什么？

新模型是另一个模型。正式切流量之前，用你自己的评测提示词重跑一遍，检查输出长度和格式，并重新确认旧模型需要的参数，例如推理相关设置或 max tokens。

## 常见问题

### model_not_found 是 Key 或账单的问题吗？

不是。Key 有问题返回 401，账单问题有各自的报错。model_not_found 表示请求里的模型 ID 不对应你这把 Key 能调用的模型；2026 年 10 月 23 日之后，最常见的原因是 OpenAI 的模型已退役。

### Router One 会把 o4-mini 自动映射到新模型吗？

不会。我们在 2026-10-27 23:43:27（北京时间）实测，请求 openai/o4-mini 返回 HTTP 404、code 为 RESOURCE_NOT_FOUND，没有被转到其他模型。替代模型由你来选，并把它的 ID 写进 model 字段。

### o4-mini 或 gpt-4-turbo 应该换成哪个 Router One 模型 ID？

OpenAI 给出的替代是：o4-mini 换 gpt-5.6-terra，gpt-4-turbo 换 gpt-5.6-sol。在 Router One 上对应 openai/gpt-5.6-terra 和 openai/gpt-5.6-sol；部署前请在 /v1/models 里确认。

### 网关能继续提供 OpenAI 已退役的模型吗？

经 OpenAI 官方 API 不能：OpenAI 在官方 API 上关停一个模型后，不管经哪个网关转发，请求都会失败。托管 OpenAI 模型的云平台有各自的退役日期，但 Router One 的目录里没有这些已退役的 ID，在 Router One 上请求它们会返回 HTTP 404、code 为 RESOURCE_NOT_FOUND。

### 怎样在下一次模型退役之前发现问题？

关注 OpenAI 的模型弃用页，它会提前数月列出每个关停日期；每次部署前，把代码发送的模型 ID 和 Router One 的 /v1/models 对一遍。

## 相关页面

- LLM API 错误码：https://router.one/zh/llm-api-error-codes
- OpenAI 兼容 API：https://router.one/zh/openai-compatible-api
- insufficient_quota 修复：https://router.one/zh/openai-insufficient-quota
- Codex 模型不支持报错排查：https://router.one/zh/codex-model-not-supported
- API 文档：https://router.one/zh/docs
- 本页规范地址：https://router.one/zh/openai-model-not-found
- 模型与每模型 token 价格：https://router.one/zh/models （markdown：https://router.one/zh/models.md ）
- 定价：https://router.one/zh/pricing
- API 文档（markdown）：https://router.one/zh/docs.md
- 公司事实（markdown）：https://router.one/zh/facts/company.md