2026 年 12 月模型变动迁移清单

Q: 2026-12-01 之后还能调用 gemini-2.5-pro 吗？

能调用，但回答的已经不是 Gemini 2.5 Pro。按 Google AI Studio 2026-11-02 的 changelog，从 2026-12-01 起所有发往 gemini-2.5-pro 的 API 请求会自动路由到 gemini-3.8-flash，并按 Gemini 3.8 Flash 的价格计费；gemini-2.5-flash 同样改由 gemini-3.5-flash-lite 处理。模型名不变，也不会报错。

Q: Gemini 2.5 改路由后费用会变高吗？

按 Google 官方牌价：gemini-3.8-flash 在 2026-12-31 前是每百万 token 输入 0.75 美元、输出 3.75 美元，2027-01-01 起翻倍到 1.50 / 7.50 美元；gemini-2.5-pro 原价（200k 以内）是 1.25 / 10 美元。所以 12 月整体更便宜，1 月起输入单价反而比 2.5 Pro 高 20%，输出仍低 25%。gemini-2.5-flash 改到 3.5 Flash-Lite 后文本价格不变，音频输入从 1.00 降到 0.30 美元。

Q: Claude Sonnet 4.5 什么时候退役？

按 Anthropic 模型弃用页，claude-sonnet-4-5-20250929 在 2026-11-30 退役，推荐替代是 claude-sonnet-5-5。退役后请求会失败。这个日期适用于 Claude API 等 Anthropic 自营平台，Amazon Bedrock 和 Google 托管的 Vertex 有各自的时间表。

Q: Opus 4.8 fast mode 移除后会怎样？

2026-11-30 之后，向 claude-opus-4-8 发送 speed: fast 的请求会返回错误；不带 speed 的普通请求不受影响，claude-opus-4-8 本身的退役时间不早于 2027-05-28。想继续用 fast mode，官方建议迁到 claude-opus-5-5，它的 fast mode 已正式可用，不再需要 beta 头。

Q: 怎么确认自己有没有用到这些模型？

在代码和配置里搜索 gemini-2.5-pro、gemini-2.5-flash（注意排除 flash-lite 和 flash-image）、claude-sonnet-4-5、speed fast、gpt-image-1.5、gpt-image-1-mini、chatgpt-image-latest，以及 gpt-5、o3 等裸模型名。Anthropic 用户还可以在 Console 的 Usage 页导出按 Key 和模型拆分的 CSV。

最后核实：2026-11-03。日期和价格均对照官方页面：Google AI Studio 的 changelog、deprecations、pricing，Anthropic 的模型弃用页、API release notes、fast mode 文档，OpenAI 的 deprecations，xAI 的 release notes。文中美元价格全部是各家官方牌价，官方随时可能调整，动手前请以原页面为准。

直接回答

11 月底到 12 月中有 4 个硬日期：11-17 Gemini 2.5 / 3.1 的 TTS 和 Live 预览模型下线；11-30 claude-sonnet-4-5-20250929 退役，claude-opus-4-8 的 speed: "fast" 移除；12-01 gemini-2.5-pro / gemini-2.5-flash 改由 3.8 Flash / 3.5 Flash-Lite 处理，旧版 GPT Image 下线；12-11 OpenAI 的 gpt-5、o3 等旧快照下线。其中最容易漏的是 Gemini 2.5：它不会报错，模型名照旧，回答你的却换成了另一个模型，账单也按新模型算，旧的 thinking_budget、temperature、预填回合等写法还可能失效。

时间线总表

日期	厂商	变动	到期后的表现	官方替代
11-02（已生效）	xAI	`grok-imagine-image-quality` 退役	改由 `grok-imagine-image-2.0` 以 `quality: low` 处理	`grok-imagine-image-2.0`
11-17	Google	`gemini-2.5-flash-preview-tts`、`gemini-2.5-pro-preview-tts`、`gemini-3.1-flash-tts-preview` 下线	下线	`gemini-3.8-flash-tts` / `gemini-3.8-flash-lite-tts`
11-17	Google	`gemini-2.5-flash-native-audio-preview-12-2025`、`gemini-3.1-flash-live-preview` 下线	下线	`gemini-3.8-live`
11-30	Anthropic	`claude-sonnet-4-5-20250929` 退役	请求失败	`claude-sonnet-5-5`
11-30	Anthropic	`claude-opus-4-8` 的 fast mode 移除	带 `speed: "fast"` 的请求报错；普通请求不受影响	`claude-opus-5-5` 的 fast mode
11-30	OpenAI	`v1/prompts`（可复用 prompt 对象）、Evals、Agent Builder 关停	关停	把 prompt 写回代码 / Promptfoo / Agents SDK
12-01	Google	`gemini-2.5-pro` → `gemini-3.8-flash`	不报错，静默换模型，按新模型计价	`gemini-3.8-flash`
12-01	Google	`gemini-2.5-flash` → `gemini-3.5-flash-lite`	不报错，静默换模型，按新模型计价	`gemini-3.5-flash-lite`
12-01	OpenAI	`gpt-image-1-mini`、`gpt-image-1.5`、`chatgpt-image-latest` 下线	下线	`gpt-image-2.5-sunburst` / `gpt-image-2.5-flare`
12-11	OpenAI	`gpt-5`、`gpt-5-mini`、`gpt-5-nano`、`gpt-5-pro`、`o3`、`o3-pro` 及其日期快照下线	下线	`gpt-5.6-sol` / `-terra` / `-luna`

xAI 截至 11-03 没有公布 12 月生效的文本模型变动。

1. Gemini 2.5 Pro / Flash：12-01 起静默换模型

Google AI Studio 在 2026-11-02 的 changelog 里写明：gemini-2.5-pro 和 gemini-2.5-flash 已弃用，从 2026-12-01 起，发往这两个模型名的所有 API 请求会自动路由到新模型，并按新模型的价格计费。changelog 没有提供退出选项。

你请求的模型名	12-01 起实际处理的模型	官方建议
`gemini-2.5-pro`	`gemini-3.8-flash`	12-01 前把模型名改成 `gemini-3.8-flash`
`gemini-2.5-flash`	`gemini-3.5-flash-lite`	12-01 前把模型名改成 `gemini-3.5-flash-lite`
`gemini-2.5-flash-lite`	不变	官方写明未弃用，暂无下线日期

注意第二行是降档：Flash 换成了 Flash-Lite。Pro 换成 Flash 也一样，它们不是同一档位的模型。按名字调用的代码一行没改，回答质量、思考深度和输出风格却可能已经不一样了。

账单怎么变（Google 官方牌价，每百万 token，美元）

gemini-2.5-pro → gemini-3.8-flash。3.8 Flash 有一段到 12-31 截止的低价，2027-01-01 起翻倍：

项目	2.5 Pro（≤200k）	2.5 Pro（>200k）	3.8 Flash（至 12-31）	3.8 Flash（2027-01-01 起）
输入	1.25	2.50	0.75	1.50
输出（含思考）	10.00	15.00	3.75	7.50
缓存读取	0.125	0.25	0.075	0.15
缓存存储（每小时）	4.50	4.50	0.50	1.00

12 月：输入和输出都比 2.5 Pro 便宜。
1 月起：200k 以内的提示，输入单价比 2.5 Pro 高 20%，缓存读取也高 20%；输出仍低 25%。读多写少的场景（RAG、长文档问答）1 月账单可能不降反升。
3.8 Flash 没有 200k 分档，超长提示在两个月份都比 2.5 Pro 便宜。

gemini-2.5-flash → gemini-3.5-flash-lite：文本 / 图像 / 视频输入 0.30、输出 2.50、缓存读取 0.03，和 2.5 Flash 相同；音频输入从 1.00 降到 0.30。

Search grounding 的计费单位也变了：2.5 系列是每天 1,500 次免费，之后每 1,000 次带 grounding 的请求 35 美元；Gemini 3 及以后是每月 5,000 次免费（所有 Gemini 3+ 模型共用），之后每 1,000 次搜索查询 14 美元，每天最多 1,500 次。官方注明一次请求可能触发多次搜索查询、每次都计费，所以重度 grounding 用户要按新单位重算。

会失效的参数

changelog 列出的不兼容改动有四类：函数调用与 thought_signature 校验、thinking_level 取代 thinking_budget、去掉采样参数、去掉预填 model 回合。对照两个新模型的迁移页：

旧写法	3.8 Flash	3.5 Flash-Lite
`thinking_budget`	改用 `thinking_level`：`low` / `medium` / `high`，默认 `medium`；传 `minimal` 会报错	改用 `thinking_level`，默认 `minimal`
`temperature` / `top_p` / `top_k`	迁移页要求删除，没写传了会怎样	当前会被忽略，官方说以后的模型会报错
最后一个非空回合是 `model`（预填）	不再支持	返回 400
`candidate_count`	Gemini 3 起不支持	同左
函数调用	generateContent 的每个 `FunctionResponse` 都要带 `call_id` 和 `name`；多模态内容放进响应体	同左
思考签名	多轮工具调用要原样回传 `thought_signature`	同左

官方没有说明改路由后，发往 gemini-2.5-pro 的请求如果还带 thinking_budget 等旧参数，会被报错、忽略还是自动换算。按最坏情况准备：12-01 之前主动改模型名、改参数，不要等改路由替你处理。

另外，gemini-3.5-flash-lite 默认几乎不思考（minimal）。原来依赖 2.5 Flash 默认思考的智能体任务，官方建议把 thinking_level 调到 medium 或 high，以免过早结束工具调用。

2. Claude Sonnet 4.5：11-30 退役

按 Anthropic 模型弃用页，claude-sonnet-4-5-20250929 在 2026-09-30 宣布弃用，2026-11-30 退役，推荐替代是 claude-sonnet-5-5。退役后请求会失败。这个日期适用于 Claude API 和其他 Anthropic 自营平台；Amazon Bedrock 和 Google 托管的 Vertex AI 有各自的时间表。

从 4.5 换到 5.5 不只是改模型名。按官方 Sonnet 5.5 迁移指南，要动的地方主要有：

思考默认开启：不带 thinking 字段的请求在 5.5 上也会思考，思考 token 按输出计费。重新评估 max_tokens。想尽量不思考，就用最低的思考设置，并把 effort 设在 high 或更低。
不能强制调用工具：tool_choice 为 any 或 tool 时返回 400：tool_choice: type "tool" and "any" are not supported for this model.。改用 auto 加 strict 工具。
删掉采样参数：temperature、top_p、top_k。
不能预填 assistant 回合：改用结构化输出或 system 指令。
显式设置 output_config.effort。output_format 移到 output_config.format。
清理 beta 头：删掉 context window 相关的 beta 头和 interleaved-thinking-2025-05-14；把 fine-grained-tool-streaming-2025-05-14 换成 eager_input_streaming。
读响应时按 type 取内容块。工具循环里的 thinking 块要原样回传。

3. Opus 4.8 fast mode：11-30 移除

Anthropic 在 2026-10-30 宣布弃用 Opus 4.8 的 fast mode，2026-11-30 移除。之后发往 claude-opus-4-8 的请求如果带 speed: "fast"，会返回错误。

范围只限 fast mode。claude-opus-4-8 这个模型照常可用，弃用页给它的退役时间是“不早于 2027-05-28”。所以有两种处理：

留在 Opus 4.8：去掉 speed: "fast" 和 fast-mode-2026-02-01 beta 头，回到标准速度。
换到 claude-opus-5-5 继续用 fast mode：官方给的就是这条路。Opus 5.5 的 fast mode 已在 10-15 结束研究预览，不再需要 beta 头。官方 fast mode 价格是每百万 token 输入 8 美元、输出 40 美元，Opus 4.8 / Opus 5 的 fast mode 是 10 / 50 美元。

选第 2 条，要连同 Opus 5.5 的行为差异一起迁：

思考不能关闭：thinking: {"type": "disabled"} 和带 budget_tokens 的手动预算都会返回 400。用 effort 控制思考深度。默认 effort 是 medium，Opus 4.8 是 high。
强制工具调用（tool_choice 为 any / tool）返回 400。
原来不带 thinking 的请求，在 4.8 上不思考，在 5.5 上会思考，单次输出 token 可能变多。
Opus 5.5 不支持 Priority Tier。
最短可缓存长度从 1,024 降到 512 token。

两条路都要注意：fast 和标准速度不共享提示缓存。从 fast 降级到标准速度的那一次请求会缓存未命中。另外，响应的 usage.speed 字段会写明实际用的是 "fast" 还是 "standard"，可以拿来做监控。

4. OpenAI：旧版 GPT Image 和 GPT-5 / o3 快照

12-01：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。gpt-image-1 已在 10-23 下线。
12-11：gpt-5 → gpt-5.6-sol、gpt-5-mini → gpt-5.6-terra、gpt-5-nano → gpt-5.6-luna、o3 → gpt-5.6-sol；gpt-5-pro 和 o3-pro → gpt-5.6-sol 加 reasoning.mode: pro。带日期的快照同时下线。
11-30：v1/prompts 和可复用 prompt 对象、Evals 平台、Agent Builder 关停。

再往后是 2027-01-14 的 GPT-4o / GPT-4.1 全家，完整日历见 GPT-4o 下线与迁移（英文）。

5. 经过网关或代理时要多做的事

自己维护网关、或者用第三方网关的团队，这一轮有三个额外风险：

按模型名配置的价格表会和上游账单对不上。 12-01 起 gemini-2.5-pro 在上游按 3.8 Flash 计价，2027-01-01 起 3.8 Flash 又涨一倍。网关如果按“模型名 → 单价”计费，12-01 和 01-01 各要改一次，否则会多收或少收。
透传模型名，等于替用户接受了静默替换。 对 gemini-2.5-*，网关要么显式映射到新模型名并顺带转换参数（thinking_budget → thinking_level、去掉采样参数和预填回合），要么返回一个说明清楚的错误，让调用方自己决定。不要什么都不做，让请求在上游被悄悄换掉。
Claude 这边反过来，不建议静默映射。 把 claude-sonnet-4-5 偷偷映射成 claude-sonnet-5-5，表面上请求还能通，实际上思考默认开启、强制工具调用直接 400、输出 token 变多，比直接报错更难排查。更稳妥的做法是在 11-30 前通知调用方，到期后返回明确的“模型已退役”错误。如果网关会自动给 Opus 4.8 请求加 speed 或 fast mode 的 beta 头，也要在 11-30 前去掉。

自查命令

在代码库和配置目录里跑一遍（需要 ripgrep）：

bash

# Gemini：排除仍可用的 flash-lite 和 flash-image
rg -n 'gemini-2\.5-(pro|flash)\b' | rg -v 'flash-(lite|image)'
rg -n 'thinking_budget|thinkingBudget'

# Claude
rg -n 'claude-sonnet-4-5'
rg -n -i 'speed.{0,4}fast|fast-mode-2026-02-01'

# OpenAI
rg -n 'gpt-image-1\.5|gpt-image-1-mini|chatgpt-image-latest'
rg -n -w -e 'gpt-5' -e 'gpt-5-mini' -e 'gpt-5-nano' -e 'gpt-5-pro' -e 'o3' -e 'o3-pro'

最后一条会命中 gpt-5.6-sol 之类的新名字，要逐条看。Anthropic 用户还可以在 Console 的 Usage 页点 Export，导出按 API Key 和模型拆分的 CSV，找出还在调用旧模型的 Key。

不在 12 月清单里的

下面这些在 12 月不会变，不必跟着慌：

gemini-2.5-flash-lite：官方写明未弃用。
gemini-2.5-flash-image：下线日期是 2027-03-15。
claude-opus-4-8 模型本身：只移除 fast mode。
claude-opus-4-5-20251101、claude-haiku-4-5-20251001：弃用页上仍是 Active。Anthropic 承诺退役前至少提前 60 天通知，按 11-03 还没有公告算，最早也要到 2027 年 1 月。
GPT-4o / GPT-4.1：2027-01-14。

来源

Google AI Studio：changelog（2026-11-02）、deprecations、pricing、Gemini 3.8 迁移、Gemini 3.6 / 3.5 Flash-Lite 迁移
Anthropic：模型弃用页、API release notes（2026-10-30）、Fast mode、Opus 5.5 迁移指南、Sonnet 5.5 迁移指南
OpenAI：Deprecations
xAI：Release notes

常见问题

2026-12-01 之后还能调用 gemini-2.5-pro 吗？

能调用，但回答的已经不是 Gemini 2.5 Pro。从 12-01 起，所有发往 gemini-2.5-pro 的请求都由 gemini-3.8-flash 处理，并按 3.8 Flash 计价；gemini-2.5-flash 改由 gemini-3.5-flash-lite 处理。模型名不变，也不会报错。

Gemini 2.5 改路由后费用会变高吗？

12 月不会，1 月要看用法。按官方牌价，3.8 Flash 在 12-31 前是输入 0.75 / 输出 3.75 美元，2027-01-01 起翻倍到 1.50 / 7.50 美元，而 2.5 Pro（200k 以内）是 1.25 / 10 美元。所以 1 月起输入单价比 2.5 Pro 高 20%，输出低 25%。2.5 Flash 换到 3.5 Flash-Lite 后文本价格不变。

Claude Sonnet 4.5 什么时候退役？

claude-sonnet-4-5-20250929 在 2026-11-30 退役，推荐替代是 claude-sonnet-5-5，退役后请求会失败。Bedrock 和 Google 托管的 Vertex 按各自的时间表。

Opus 4.8 fast mode 移除后会怎样？

11-30 之后，向 claude-opus-4-8 发 speed: "fast" 会报错；不带 speed 的请求不受影响。想继续用 fast mode，就迁到 claude-opus-5-5，那里的 fast mode 已正式可用，不需要 beta 头。

怎么确认自己有没有用到这些模型？

在代码和配置里跑上面的自查命令。Anthropic 用户还可以从 Console 的 Usage 页导出按 Key 和模型拆分的 CSV。

2026 年 12 月模型变动迁移清单 ​

时间线总表 ​

1. Gemini 2.5 Pro / Flash：12-01 起静默换模型 ​

账单怎么变（Google 官方牌价，每百万 token，美元） ​

会失效的参数 ​

2. Claude Sonnet 4.5：11-30 退役 ​

3. Opus 4.8 fast mode：11-30 移除 ​

4. OpenAI：旧版 GPT Image 和 GPT-5 / o3 快照 ​

5. 经过网关或代理时要多做的事 ​

自查命令 ​

不在 12 月清单里的 ​

来源 ​

常见问题 ​

2026-12-01 之后还能调用 gemini-2.5-pro 吗？ ​

Gemini 2.5 改路由后费用会变高吗？ ​

Claude Sonnet 4.5 什么时候退役？ ​

Opus 4.8 fast mode 移除后会怎样？ ​

怎么确认自己有没有用到这些模型？ ​