跳到主要内容
注册

OpenAI model_not_found:模型已退役,换一个模型 ID

上周还正常的请求,现在返回 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
{
  "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:

OpenAI 在 2026 年 10 月 23 日关停了哪些模型?
已退役 IDOpenAI 给出的替代Router One 模型 ID
o4-minigpt-5.6-terraopenai/gpt-5.6-terra
gpt-3.5-turbogpt-5.6-terraopenai/gpt-5.6-terra
o3-minigpt-5.6-solopenai/gpt-5.6-sol
o1gpt-5.6-solopenai/gpt-5.6-sol
gpt-4-turbogpt-5.6-solopenai/gpt-5.6-sol
gpt-4gpt-5.6-solopenai/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
{
  "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
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
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 对一遍。