作者注：一页看全 OpenAI、Anthropic、Google 从 2026 年 11 月 17 日到 2027 年 4 月 1 日的 10 个下线节点，以及每个节点该换成什么、改哪几行。
先说结论：今年还剩 11 月 17 日和 12 月 1 日两个小节点，真正会让接口直接失败的是 11 月 30 日和 12 月 11 日，其余节点都在明年。 11 月 30 日 Claude Sonnet 4.5 和 OpenAI 三个产品同时关停，12 月 11 日 GPT-5 全家和 o3 系列下线，这两天之后旧型号名会直接失败。本文按日期列出全部 10 个下线节点，读完你能判断三件事：自己用的型号在不在名单里、最晚哪天动手、具体改哪几行。
这不是小道消息，所有日期均来自 OpenAI、Anthropic、Google 的官方弃用页（抓取日期 2026-10-26），文中的”现在”都按这一天计算。
模型退役日历总表：10 个节点一览
下表按时间正序排列。”日期性质”一列用于区分确定日期和最早可能日期。确定日期是官方给出的关停日，到期就停；最早可能日期是下限，实际下线可能更晚。
| # | 日期 | 日期性质 | 谁 | 影响型号 | 换成什么 | 会不会直接报错 |
|---|---|---|---|---|---|---|
| 1 | 2026-11-17 | ⚠️ 最早可能 | Gemini | gemini-3.1-flash-tts-preview、gemini-2.5-flash-preview-tts、gemini-2.5-pro-preview-tts、gemini-3.1-flash-live-preview、gemini-2.5-flash-native-audio-preview-12-2025 | TTS 类换 gemini-3.8-flash-tts 或 gemini-3.8-flash-lite-tts；live 类换 gemini-3.8-live | 关停后会失败 |
| 2 | 2026-11-30 | ✅ 确定 | OpenAI | 可复用 prompt（v1/prompts）、Evals 平台、Agent Builder | 代码内置 prompt / Promptfoo / Agents SDK 或 ChatGPT Workspace Agents | 会 |
| 3 | 2026-11-30 | ✅ 确定 | Anthropic | claude-sonnet-4-5-20250929 | claude-sonnet-5-5 | 会；换后旧参数也会 400 |
| 4 | 2026-12-01 | ✅ 确定 | OpenAI | gpt-image-1-mini、gpt-image-1.5、gpt-image-1.5-2025-12-16、chatgpt-image-latest | gpt-image-2.5-sunburst 或 gpt-image-2.5-flare | 会 |
| 5 | 2026-12-11 | ✅ 确定 | OpenAI | gpt-5、gpt-5-mini、gpt-5-nano、gpt-5-pro、o3、o3-pro（含日期快照） | gpt-5.6-sol / terra / luna，pro 两档另加参数 | 会 |
| 6 | 2027-01-06 | ✅ 确定 | OpenAI | tts-1、tts-1-hd、gpt-4o-mini-tts 及其快照 | gpt-realtime-2.1-mini | 会 |
| 7 | 2027-01-14 | ✅ 确定 | OpenAI | gpt-4o（2024-08-06、2024-11-20）、gpt-4o-mini-2024-07-18、gpt-4.1-2025-04-14、gpt-4.1-mini-2025-04-14 | gpt-6-luna | 会 |
| 8 | 2027-01-20 | ✅ 确定 | OpenAI | gpt-realtime、gpt-audio 等 8 个旧 realtime / audio 型号 | gpt-realtime-2.1、gpt-audio-1.5、gpt-realtime-2.1-mini | 会 |
| 9 | 2027-02-26 | ✅ 确定 | OpenAI | whisper-1、gpt-4o-transcribe、gpt-4o-mini-transcribe、gpt-4o-transcribe-diarize | gpt-live-transcribe 或 gpt-transcribe | 会 |
| 10 | 2027-04-01 | ✅ 确定 | OpenAI | gpt-5.3-codex、gpt-5.1、gpt-5.4-nano（含快照） | gpt-6-sol / gpt-6-luna | 会 |
背景补充：2026-10-23 已关停一批旧型号，包括 gpt-3.5-turbo、gpt-4、gpt-4-turbo-2024-04-09、gpt-4.1-nano、gpt-image-1、o1、o1-pro、o3-mini、o4-mini 等。API易 的总表里这些型号目前仍挂着价格，型号与价格以平台型号列表为准，实际能否调用以请求返回为准。
🚀 快速对照：如果你通过 API易 apiyi.com 调用，迁移通常只需在同一个 Key 下换型号名；替代型号是否已上架，以平台型号列表为准。
十一月模型退役：Gemini 预览版、OpenAI 三产品、Sonnet 4.5
11 月 17 日：Gemini 五个预览版（最早可能）
- 关什么：表中第 1 行的五个 TTS / live 预览版。注意 11 月 17 日是 shutdown date，属于最早可能日期。
- 现象：关停后，这些型号的请求会失败。
- 改哪里：TTS 类改为 gemini-3.8-flash-tts 或 gemini-3.8-flash-lite-tts，live 类改为 gemini-3.8-live。
11 月 30 日：OpenAI 三个产品级关停
- 关什么：可复用 prompt（
v1/promptsAPI 与 prompt 对象）、Evals 平台、Agent Builder。其中 Evals 从 10 月 31 日起，存量评测就会变成只读。 - 现象：调用
v1/prompts或引用 prompt 对象的请求会失败，Evals 的控制台和 API 都无法使用。 - 改哪里：把 prompt 内容搬回应用代码（参考官方 “Migrate from prompt objects” 指南）；评测迁到 Promptfoo；Agent Builder 迁到 Agents SDK 或 ChatGPT Workspace Agents，ChatKit 继续保留。
11 月 30 日：Claude Sonnet 4.5 迁移改动清单
这一条最容易踩坑。只改型号名还不够，Sonnet 5.5 对多个旧参数会直接返回 400。
| 改动项 | Sonnet 4.5 写法 | Sonnet 5.5 写法 | 不改的后果 |
|---|---|---|---|
| 思考参数 | enabled + budget_tokens | adaptive + output_config.effort | 400 |
| assistant 预填 | 支持 | 不支持 | 400 |
| 强制工具 | tool_choice 为 any / tool | 只能 auto + strict tool use | 400 |
| computer use | computer_20250124 | computer_toolset_20260801（Bedrock 用 computer_20251124） | 不再接受 |
| 输出格式 | output_format | output_config.format | 弃用；不带 beta header 会 400 |
具体要改的参数和报错原文：
- 旧写法
thinking: {"type": "enabled", "budget_tokens": N}会返回"thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" - 如果要关掉开头的思考，改用
thinking: {"type": "between_tools"}，适用于 high effort 及以下档位 - 4.5 上没有 effort 参数，迁移后需要显式设置
output_config.effort - 使用预填会返回
This model does not support assistant message prefill. The conversation must end with a user message。控制输出格式改用 structured outputs，开场白写进 system，续写和上下文提醒都挪到 user 轮次 interleaved-thinking-2025-05-14可以删除；fine-grained-tool-streaming-2025-05-14与工具集同时使用会报 400，改为给每个工具加eager_input_streaming: true- Sonnet 5.5 产出的思考块只在产出它的账号（或关联账号）内有效，跨账号回传会被丢弃，但请求本身不会失败
迁移也有两条利好：最小可缓存长度从 1024 tokens 降到 512 tokens；上下文窗口更大，上下文相关的 beta header 可以去掉。
十二月模型退役：GPT Image 与 GPT-5、o3 系列
12 月 1 日：GPT Image 老型号
- 关什么：gpt-image-1-mini、gpt-image-1.5、gpt-image-1.5-2025-12-16、chatgpt-image-latest。
- 现象：图像生成请求会失败。
- 改哪里：型号名换成 gpt-image-2.5-sunburst 或 gpt-image-2.5-flare，二者都支持 chat 和 images 端点。
12 月 11 日：GPT-5 全家与 o3 系列
- 关什么：gpt-5、gpt-5-mini、gpt-5-nano、gpt-5-pro、o3、o3-pro，以及它们的日期快照。
- 现象：旧型号名会直接失败。如果 pro 两档只改了型号名，请求不会报错，但会丢掉官方要求的 reasoning.mode: pro 这一项。
- 改哪里：gpt-5 和 o3 换 gpt-5.6-sol，mini 换 gpt-5.6-terra，nano 换 gpt-5.6-luna；gpt-5-pro 和 o3-pro 换 gpt-5.6-sol，并同时加上
reasoning.mode: pro。
明年一月模型退役：TTS、GPT-4 系、旧 realtime
- 1 月 6 日：tts-1、tts-1-hd、gpt-4o-mini-tts（含 2025-03-20、2025-12-15 两个快照）关停，统一换成 gpt-realtime-2.1-mini。同一天起，自助微调不再接受新任务，老客户也一样；已经微调好的模型可以继续推理，直到其基座模型退役。
- 1 月 14 日：gpt-4o 的 2024-08-06 和 2024-11-20 快照、gpt-4o-mini-2024-07-18、gpt-4.1-2025-04-14、gpt-4.1-mini-2025-04-14 关停，全部换成 gpt-6-luna。代码里写死日期快照的项目，需要全局搜索替换。
- 1 月 20 日：gpt-realtime、gpt-audio、gpt-4o-audio、gpt-4o-realtime、gpt-realtime-mini、gpt-audio-mini、gpt-4o-mini-realtime、gpt-4o-mini-audio 全部停用。官方给出的替代是 gpt-realtime-2.1、gpt-audio-1.5、gpt-realtime-2.1-mini，具体对应关系以官方退役页为准。同一天官方表里还有一条是换快照、不是停用：gpt-4o-mini-transcribe 的 2025-03-20 快照要换成 2025-12-15 快照。
这三个节点到期后，旧型号请求都会失败。
二月到四月模型退役：转写、Codex 与 5.1
- 2 月 26 日：whisper-1、gpt-4o-transcribe、gpt-4o-mini-transcribe、gpt-4o-transcribe-diarize 停用，官方方向是 gpt-live-transcribe 或 gpt-transcribe。接口也要一起换，
v1/audio/translations改为v1/realtime/translations。 - 4 月 1 日：gpt-5.3-codex 和 gpt-5.1（含 2025-11-13 快照）换成 gpt-6-sol，gpt-5.4-nano（含 2026-03-17 快照）换成 gpt-6-luna。
平台侧目前的情况：whisper-1、gpt-transcribe、gpt-live-transcribe 都不在 API易 总表里，gpt-5.3-codex 也不在，因此这几条只能按官方方向规划迁移。gpt-transcribe 和 gpt-live-transcribe 属于官方已发布、平台尚未上架的型号，API易 会尽快推出该模型。
Gemini 静默改道：不报错，但账单变了
这一节要和上面的内容分开看。前面的节点到期会报错，Gemini 的两个 Flash 则是静默改道：端点不关，请求照常成功，只是背后实际干活的换成了新型号。
| 你请求的型号 | 实际回答的型号 | 价格变化（输入 / 输出 / 缓存读） |
|---|---|---|
| gemini-3.7-flash | gemini-3.8-flash | 0.75 / 3.75 / 0.075 → 不变 |
| gemini-3.5-flash | gemini-3.6-flash | 1.5 / 9 / 0.15 → 1.5 / 7.5 / 0.15 |
改道带来的影响：不会出现 model not found，但计费按实际干活的新型号计算，思考行为和输出风格也可能与老型号不同。如果你发现”账单和以前对不上”，或者输出风格突然变了，先排查这一条。另外，2.5 系列没有被弃用，但只对以前用过 2.5 的账号开放；新项目官方建议使用 3.5 Flash-Lite 或 3.8 Flash。
模型退役的最早日期，不要当成下线日
Anthropic 状态表里写的”不早于”，以及 Gemini 的 shutdown date，都是最早可能日期。它们只是下限，并不是确定的下线日。有两条需要特别留意：
- claude-haiku-4-5-20251001：最早日期 2026-10-15 已经过去，但官方还没有公布具体下线日。这类型号随时可能收到通知，建议提前准备好替代方案。
- claude-opus-4-5-20251101：不早于 2026-11-24，年底前随时可能发出具体日期的通知。
其余型号的下限都在更远的时间：claude-opus-4-6 不早于 2027-02-05，claude-sonnet-4-6 不早于 2027-02-17。
模型退役动手清单：三步走
- 查用量：在请求日志和账单明细里按型号名统计调用，再在代码仓库中全局搜索模型名字符串，日期快照名（如
-2025-08-07）也要一起搜。 - 改模型名：按总表替换。如果通过 API易 调用，
base_url保持https://api.apiyi.com/v1不变，只改model字段即可。pro 两档要同时加上reasoning.mode: pro。 - 回归测试：重点跑五项。
- 思考参数：
thinking的写法，以及output_config.effort是否已设置 - assistant 预填：对话最后一条必须是 user 消息
tool_choice：只能用auto- 流式：检查
eager_input_streaming: true是否已替换旧 beta - computer use：工具版本号是否已更新
💡 迁移建议：可以先在 API易 apiyi.com 用新型号名跑一遍回归用例，确认没有 400 再切生产流量。
模型退役平台侧对照：单价怎么变
以下单价来自 API易 平台型号列表（数据更新于 2026-10-25），单位为美元每百万 tokens，按输入 / 输出 / 缓存读排列。型号与价格以平台型号列表为准。
12 月 11 日这一批
| 现型号 | 现价 | 替代型号 | 替代价 |
|---|---|---|---|
| gpt-5 | 1.25 / 10 / 0.125 | gpt-5.6-sol † | 4 / 20 / 0.4 |
| gpt-5-mini | 0.25 / 2 / 0.025 | gpt-5.6-terra † | 2 / 12 / 0.2 |
| gpt-5-nano | 0.05 / 0.4 / 0.005 | gpt-5.6-luna † | 0.2 / 1.2 / 0.02 |
| gpt-5-pro | 15 / 120 / 1.5 | gpt-5.6-sol †（加 reasoning.mode: pro） |
4 / 20 / 0.4 |
| o3 | 3 / 12 / 0.75 | gpt-5.6-sol † | 4 / 20 / 0.4 |
| o3-pro | 20 / 80 / 5 | gpt-5.6-sol †（加 reasoning.mode: pro） |
4 / 20 / 0.4 |
† 表示阶梯计价：单次输入超过 272,000 tokens 后，输入价翻倍（sol 变 8、terra 变 4、luna 变 0.4），输出价按对应档的输入价乘以倍率计算。从表中可以看到，这一批的主力型号 gpt-5、mini、nano、o3 换过去后单价都是上涨的。gpt-5 到 gpt-5.6-sol，从 $1.25 输入 / $10 输出涨到 $4 / $20，预算需要提前调整。pro 两档单价表上的数字较低，但开启 pro 模式后实际消耗多少，需要在自己的账单里核对。
其他节点
| 节点 | 现型号与价格 | 替代型号与价格 |
|---|---|---|
| 11-30 | claude-sonnet-4-5-20250929：3 / 15 / 0.3 | claude-sonnet-5-5：2 / 10 / 0.1 |
| 12-01 | gpt-image-1.5：5 / 32 / 1.25；gpt-image-1-mini：2 / 8 / 0.2 | gpt-image-2.5-sunburst、gpt-image-2.5-flare：均为 5 / 30 / 1.25 |
| 01-06 | tts-1：30 / 30（无缓存读价）；tts-1-hd：60 / 60（无缓存读价） | gpt-realtime-2.1-mini：0.6 / 2.4 / 0.06 |
| 01-14 | gpt-4o：2.5 / 10 / 1.25；gpt-4o-mini：0.15 / 0.6 / 0.075；gpt-4.1：2 / 8 / 0.5；gpt-4.1-mini：0.4 / 1.6 / 0.1 | gpt-6-luna †：0.1 / 0.5 / 0.01，超 272,000 tokens 后输入 0.2 |
| 04-01 | gpt-5.3-codex（平台未上架） | gpt-6-sol †：2 / 10 / 0.2，超 272,000 tokens 后输入 4 |
在所有改道中，不改代码、单价就自动下降的只有一处：Gemini 3.5 Flash 改道到 3.6 Flash 后，输出价从 $9 降到 $7.5。
模型退役常见问题 FAQ
Q1：只改模型名够不够？
大部分 OpenAI 型号只改名就够了，但有两类例外。一是 gpt-5-pro 和 o3-pro 换到 gpt-5.6-sol 时，必须同时加 `reasoning.mode: pro`，否则 pro 模式就丢了。二是 Claude Sonnet 4.5 迁到 5.5，思考参数、预填、`tool_choice`、computer use 都要按上文清单修改。
Q2：换了以后账单会怎么变？
12 月 11 日这一批的主力型号换过去后单价上涨，† 型号单次输入超过 272,000 tokens 后输入价还会翻倍。可以在 API易 apiyi.com 的型号列表中按新型号名核对单价，型号与价格以平台型号列表为准。
Q3：官方日期会不会提前？
OpenAI 表中的日期是确定的关停日，并且都写明了提前通知的时长。Anthropic 的”不早于”和 Gemini 的 shutdown date 是最早可能日期，实际下线不会早于这个日子，但可能随时收到具体通知，Haiku 4.5 和 Opus 4.5 都属于这种情况。
Q4：平台什么时候跟上？
gpt-5.6 三代、claude-sonnet-5-5、gpt-image-2.5 两款、gpt-6-luna、gpt-6-sol、gpt-realtime-2.1-mini 目前已在 API易 apiyi.com 的型号列表中。gpt-transcribe 和 gpt-live-transcribe 还未上架，API易 会尽快推出该模型。
模型退役日历核心要点 Key Takeaways
- 两个关键日子：11 月 30 日和 12 月 11 日到期，旧型号名会直接失败
- Sonnet 4.5 迁移：思考参数、预填、tool_choice 都会触发 400，需要整体改造
- pro 两档：迁移时必须加
reasoning.mode: pro - Gemini 改道：请求不报错，但计费按新型号计算，账单对不上时先查这条
- “不早于”是下限：Haiku 4.5、Opus 4.5 随时可能收到通知
- 单价上涨：12 月 11 日这一批换过去单价更高，需要提前调整预算
总结
这份模型退役日历里共有 10 个节点。今年要处理的是 11 月 17 日、11 月 30 日、12 月 1 日、12 月 11 日这四个，其中 11 月 30 日和 12 月 11 日最紧急，剩下的节点都在明年一月到四月。
带走一句话：换模型这件事，在平台侧就是同一个 Key 换一个型号名。通过 API易 apiyi.com 调用时，具体可用型号和价格以平台型号列表为准。
📚 参考资料
- OpenAI Deprecations：官方退役时间表
- 链接：
platform.openai.com/docs/deprecations - Claude Model Deprecations 与 Sonnet 5.5 Migration Guide：Anthropic 退役状态与迁移指南
- 链接：
platform.claude.com - Gemini API Deprecations：Google 改道与关停列表
- 链接：
ai.google.dev/gemini-api/docs/deprecations - API易 型号列表：平台型号与价格
- 链接：
docs.apiyi.com/models
作者：APIYI 技术团队
技术交流：欢迎在 API易 apiyi.com 首页联系我们，更多资料可访问 docs.apiyi.com 文档中心
