先分清：哪張表、哪一天、哪個模型 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。