先分清：哪张表、哪一天、哪个模型 ID
- Gemini API 弃用表（更新至 2026-09-23）里，10 月确认关停的是
gemini-2.5-flash-image，最早日 10 月 2 日。来源：Gemini deprecations。 - Google Cloud Gemini Enterprise Agent Platform 生命周期表（更新至 2026-09-22）把
gemini-2.5-pro/gemini-2.5-flash/gemini-2.5-flash-lite写到 2026-10-20。同一模型 ID，不是同一张日历。来源：Model versions and lifecycle。 - 搜「10 月 16 日 2.5 全线下线」对不上 Gemini API 现表：
gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite写的是 No shutdown date announced。官方另注：2.5 文本模型现限老用户，新项目用 3.5 Flash-Lite 或 3.8 Flash。 - 表里给 flash-image 的替换
gemini-3.1-flash-image-preview已在 2026-06-25 关停。真正还能打的终点是gemini-3.1-flash-image（5 月 28 日 GA，未宣布关停）。 - 关停后该端点不可用。迁移先分平台，再改模型字符串，再测图像 / 工具调用；旧库
google-generativeai应迁到 Google GenAI SDK。
「Gemini 10 月下线」现在只能答：先问你走的是 Gemini API 还是 Cloud。把 10 月 16 日写进所有 2.5 模型，就是把两张表叠成一张。
10 月到底下线什么：Gemini API 和 Cloud 不是同一天
今天是 2026 年 9 月 24 日。搜 Gemini 10月下线 的人，第一件要做的不是改代码，是分清请求打在哪条轨道。Gemini API（AI Studio / generativelanguage.googleapis.com / google-genai 默认密钥）用 ai.google.dev 弃用表。Vertex / Gemini Enterprise Agent Platform 用 Cloud 生命周期表。两张表都写了：列出的日期是最早可能退休日，确切关停会另发通知。
Gemini API 这一侧，10 月窗口真正钉死模型 ID 的是图像线 gemini-2.5-flash-image（发布 2025-10-02，最早关停 2026-10-02）。同周附近还有托管 Agent antigravity-preview-05-2026 最早 10 月 5 日关，替换 antigravity-preview-09-2026。gemini-omni-flash-preview 的最早日是 9 月 30 日，替换 gemini-omni-1.1-flash——这已经不是「下个月」的事。2.0 Flash / Flash-Lite 已在 2026-06-01 关停，不必再写进 10 月清单。
| 模型 ID | Gemini API | Cloud Agent Platform | 依据 |
|---|---|---|---|
gemini-2.5-flash-image | 最早 2026-10-02 | 2027-03-15 | 官方两表；Cloud 更晚 |
gemini-2.5-pro | 未宣布关停日 | 2026-10-20 | API 限老用户；Cloud 有退休日 |
gemini-2.5-flash | 未宣布关停日 | 2026-10-20 | 同上 |
gemini-2.5-flash-lite | 未宣布关停日 | 2026-10-20 | 同上 |
antigravity-preview-05-2026 | 最早 2026-10-05 | — | Gemini API 托管 Agent |
gemini-omni-flash-preview | 最早 2026-09-30 | — | 本周窗口，不是 10 月 |
gemini-2.0-flash | 已于 2026-06-01 关停 | 已于 2026-06-01 关停 | 不要写进 10 月待办 |
同一行 gemini-2.5-flash-image：API 最早 10 月 2 日，Cloud 写到 2027-03-15。反过来，2.5 文本三件套在 API 上没有关停日，在 Cloud 上是 10 月 20 日。把「10 月 Gemini 下线」说成一条全站倒计时，会迁错仓库。模型目录见 Gemini models。
10 月 16 日从哪来，2.5 文本模型现在什么状态
2026 年 7 月前后，Gemini API 弃用表一度给 2.5 Pro / Flash / Flash-Lite 写过 October 16, 2026。8 月初这三行改成「未宣布关停日」，现页上看不到 10 月 16。Cloud 侧同期从「不早于 10 月 16」挪到表上的 10 月 20 日。二次传播还在用旧截图，所以搜索结果会同时出现 16、20、「未宣布」三种说法。本稿以 9 月 22–23 日两张官方表为准，不把已撤回的 16 日写成现行截止日期。
API 页在 2.5 Pro / Flash 表上方另有说明：为了容量，2.5 文本模型只继续服务曾经用过的用户，没有被标成 deprecated，会「继续服务直到另行通知」。新项目官方点名 3.5 Flash-Lite 或 3.8 Flash。所以：老项目在 Gemini API 上不是「10 月 16 日闹钟一响全 404」；新项目也不该再新建 2.5 文本线。论坛里出现过个别密钥对 gemini-2.5-flash 返回 404 / no longer available——那是容量与账号资格问题，不能反证「官方已经写了 10 月 16」。确切关停仍看 Release notes / changelog。
替代模型怎么选：跟着替换链，不要抄已死的 preview
官方表有一列 Recommended replacement。对图像线，这一列现在是陷阱：gemini-2.5-flash-image → gemini-3.1-flash-image-preview（2026-06-25 已关）→ gemini-3.1-flash-image。生产要打链的终点。Cloud 图像线给的替换是 gemini-3.1-flash-lite-image，和 API 的 GA 名不一样，复制前看你在哪张表。
| 你现在用的 | 平台 | 实际应迁到 | 不要停在 |
|---|---|---|---|
gemini-2.5-flash-image | Gemini API | gemini-3.1-flash-image | 已关的 …-preview |
gemini-2.5-flash-image | Cloud | gemini-3.1-flash-lite-image | 把 API 的 ID 直接贴进 Vertex |
| 2.5 Pro（Cloud） | Agent Platform | gemini-3.5-flash | 继续赌 2.5 过 10-20 |
| 2.5 Flash（Cloud） | Agent Platform | gemini-3.5-flash-lite 或 gemini-3.1-flash-lite | 只改名字不测工具调用 |
| 2.5 Flash-Lite（Cloud） | Agent Platform | gemini-3.1-flash-lite 或 Gemma 4 | 默认当成同价同能力 |
| 新项目（API） | Gemini API | gemini-3.5-flash-lite 或 gemini-3.8-flash | 新建 2.5 文本线 |
价格不是这次的主词，但换代会改账单。3.x Flash 有导入价窗口，thinking token 计入输出。单价和免费额度见 Gemini API 价格；3.5 系列能力边界见 Gemini 3.5 Pro 是什么。官方现价以 Gemini API pricing 当天为准。写代码还要比 Claude / GPT，见 GPT-5.6 与 Claude、Gemini。
Gemini API 怎么迁：先盘点，再改 ID，再测关键路径
目标：在最早关停日之前，生产请求不再打到将关的 ID，并且图像、函数调用、结构化输出仍过验收。Cloud 文档给赶工路径是三步——改到推荐升级、测关键功能、按原流程发布。API 侧多一步：确认你不是还在用已停的旧 SDK。
- 盘点调用点：在仓库和密钥配置里搜
gemini-2.5-flash-image、gemini-2.5-pro、gemini-2.5-flash、gemini-omni-flash-preview、antigravity-preview-05-2026、google-generativeai。 - 标平台：每条调用标 Gemini API 或 Cloud / Vertex。同一字符串在两张表上日期不同，不能共用一张迁移单。
- 解析替换链：表上的 replacement 若已关，继续往下找到仍在服的 GA ID。图像线终点是
gemini-3.1-flash-image，不是 preview。 - 改模型字符串并锁定 SDK：新代码走
google-genai的Client，不要再GenerativeModel('…')。对照：Migrate to the Google GenAI SDK。 - 测关键路径：图像生成、函数调用 / MCP、JSON schema、长上下文、流式。Agent 栈怎么接模型见 2026 AI Agent 技术栈。
- 灰度发布：先影子流量对比输出和单价，再切生产。准备 404 /
no longer available的回退模型，不要只靠「表上还没写日期」。
# pip install -U google-genai
from google import genai
client = genai.Client() # GEMINI_API_KEY
# 不要：gemini-2.5-flash-image（API 最早 2026-10-02 关）
# 不要：gemini-3.1-flash-image-preview（2026-06-25 已关）
resp = client.models.generate_content(
model="gemini-3.1-flash-image",
contents="Generate a 16:9 product hero still",
)
Cloud 上 2.5 文本三件套若还在 Agent Platform，按官方列迁到 3.5 Flash / 3.5 Flash-Lite / 3.1 Flash-Lite，并在 10 月 20 日之前做完关键路径。他们写明退休日可以延后，不会提前。赶工三步仍然适用：改推荐升级 → 测任务关键功能 → 正常发布。
迁移本身是改配置和回归，不是换一台电脑。但对照两套官方表、跑图像回归、看 thinking token 账单，需要一台不合盖的机器。日租云端 Mac mini 适合把新旧模型 ID 隔开目录来跑，开通清单见 租 Mac 开通验收。
FAQ
Gemini 2.5 Pro 会在 2026 年 10 月 16 日下线吗？
在 Gemini API 上：现表写未宣布关停日，并限老用户继续用。在 Cloud Agent Platform 上：退休日写 2026-10-20。10 月 16 日是 API 页一度写过、后来撤掉的日期，不要当现行全平台截止日期。
gemini-2.5-flash-image 10 月 2 日一定会 404 吗？
官方写的是最早可能关停日，确切日期会另通知。不要赌延期；10 月 2 日前切到 gemini-3.1-flash-image。Cloud 上这条图像模型写的是 2027-03-15，不要和 API 混用。
新项目还能选 Gemini 2.5 吗？
API 官方要新项目用 3.5 Flash-Lite 或 3.8 Flash。2.5 文本模型还在服老用户，但不是新项目默认。Cloud 上 2.5 文本线还有 10 月 20 日退休日，更不该新建。
只改 model 字符串够不够？
常常不够。preview 可能已经关；旧 SDK 的 GenerativeModel 入口和 Client 不同；图像、函数调用、thought / thinking token 都要回归。先分平台，再走替换链终点。
下线后请求会返回什么？
关停后该端点不再可用。现场报告过 404 和 “This model … is no longer available”。生产要有回退模型和告警，不要等第一封用户投诉。
接下来看什么
Gemini 10 月下线不是一张全站倒计时。API：10 月 2 日盯 gemini-2.5-flash-image，10 月 5 日盯旧 Antigravity preview。Cloud：10 月 20 日盯 2.5 文本三件套。2.5 Pro / Flash 在 API 上没有现行关停日，也不是「16 日全挂」。
本周先搜仓库里的模型 ID，按平台拆迁移单，图像线打到 gemini-3.1-flash-image。日期以官方表为准，表会改；改完再回来对一次 deprecations 和 lifecycle。