本指南涵蓋下列主題:
- 重要術語:瞭解穩定版、舊版和停用模型的定義。
- 最新穩定模型:查看最新且建議使用的模型清單。
- 舊版穩定模型:瞭解舊版支援的模型,以及建議的升級路徑。
- 遷移至最新的穩定模型:取得如何更新應用程式以使用最新模型的說明。
- Gemini 自動更新別名:瞭解如何使用別名,自動指向最新模型版本。
- 停售型號:查看不再提供或支援的型號清單。
重要詞彙
穩定模型:公開發布的模型版本,可用於實際工作環境並提供支援。穩定模型版本通常會有淘汰日期,也就是模型可用的最後一天。該模型將無法再存取,Google 也不會提供支援。
已淘汰模型:模型版本已過淘汰日期,且永久停用。Google 不再支援已淘汰的機型,因此您無法存取這些機型。如果 API 要求參照已淘汰的模型 ID,通常會傳回
404 Not Found
錯誤。請參閱「已淘汰的機型」。建議升級:建議升級至最新穩定模型。與舊版穩定模型相比,最新穩定模型通常效能更佳,功能也更多。如需具體建議,請參閱「舊版穩定模型」和「已淘汰模型」一節中的升級路徑。
最新穩定版模型
下表列出最新的穩定模型:
模型 ID | 發布日期 | 退役日期 | 詳細資料 |
---|---|---|---|
gemini-2.5-pro |
2025 年 6 月 17 日 | 2026 年 6 月 17 日 | |
gemini-2.5-flash |
2025 年 6 月 17 日 | 2026 年 6 月 17 日 | |
gemini-2.5-flash-lite |
2025 年 7 月 22 日 | 2026 年 7 月 22 日 | |
gemini-2.0-flash-001 |
2025 年 2 月 5 日 | 2026 年 2 月 5 日 | Gemini 2.0:Flash、Flash-Lite 和 Pro - Google 開發人員網誌 |
gemini-2.0-flash-lite-001 |
2025 年 2 月 25 日 | 2026 年 2 月 25 日 | Gemini 2.0:Flash、Flash-Lite 和 Pro - Google 開發人員網誌 |
gemini-embedding-001 |
2025 年 5 月 20 日 | 未公布退場日期 | |
text-embedding-005 |
2024 年 11 月 18 日 | 未公布退場日期 | |
text-multilingual-embedding-002 |
2024 年 5 月 14 日 | 未公布退場日期 | |
multimodalembedding@001 |
2024 年 2 月 12 日 | 未公布退場日期 |
舊版穩定模型
下表列出舊版穩定模型:
模型 ID | 發布日期 | 退役日期 | 建議升級 |
---|---|---|---|
gemini-1.5-pro-002 * |
2024 年 9 月 24 日 | 2025 年 9 月 24 日 | gemini-2.0-flash |
gemini-1.5-flash-002 * |
2024 年 9 月 24 日 | 2025 年 9 月 24 日 | gemini-2.0-flash-lite |
text-embedding-004 |
2024 年 5 月 14 日 | 2025 年 11 月 18 日 | gemini-embedding-001 |
*新專案不適用。
遷移至最新的穩定模型
如要瞭解如何遷移至最新的穩定模型,請參閱「使用 Vertex AI 的 Gemini API 將應用程式遷移至 Gemini 2」。本指南提供遷移步驟,協助您盡量降低風險,並有效使用新模型。
如要更新應用程式,解決模型達到淘汰日期而導致的錯誤,請按照下列步驟操作:
- 更新應用程式,使其指向建議的升級版本。
- 測試所有任務關鍵功能,確認這些功能是否正常運作。
- 部署更新。
Gemini 自動更新別名
您可以指定模型,方法是使用固定版本 ID (例如 gemini-1.5-pro-002
) 或自動更新的別名 (例如 gemini-1.5-pro
)。Gemini 模型的自動更新別名一律會指向該模型的最新穩定版本。發布新的穩定版時,別名會自動指向新版本。
下表比較這兩個選項。
選項 | 說明 | 優點 | 用途 |
---|---|---|---|
固定的版本 (例如 gemini-1.5-pro-002 ) |
使用特定且不會變更的模型版本。 | 行為可預測且輸出內容穩定,因為基礎模型不會變更。 | 需要一致性和可重現性的正式環境。 |
自動更新的別名 (例如 gemini-1.5-pro ) |
自動指向模型的最新穩定版本。 | 無須手動變更程式碼,即可使用最新功能和改善項目。 | 開發或非重要應用程式,這類應用程式優先採用最新模型功能,而非嚴格的版本一致性。 |
下表列出 Gemini 模型自動更新的別名,以及這些別名指向的最新穩定模型。
自動更新的別名 | 穩定版參考資料 |
---|---|
gemini-2.0-flash-lite |
gemini-2.0-flash-lite-001 |
gemini-2.0-flash |
gemini-2.0-flash-001 |
gemini-1.5-pro |
gemini-1.5-pro-002 |
gemini-1.5-flash |
gemini-1.5-flash-002 |
已淘汰的模型
查看已淘汰的機型
模型 ID | 發布日期 | 退役日期 | 建議升級 |
---|---|---|---|
gemini-1.5-pro-001 |
2024 年 5 月 24 日 | 2025 年 5 月 24 日 | gemini-2.0-flash |
gemini-1.5-flash-001 |
2024 年 5 月 24 日 | 2025 年 5 月 24 日 | gemini-2.0-flash-lite |
textembedding-gecko@003* |
2023 年 12 月 12 日 | 2025 年 5 月 24 日 | gemini-embedding-001 |
textembedding-gecko-multilingual@001 |
2023 年 11 月 2 日 | 2025 年 5 月 24 日 | gemini-embedding-001 |
gemini-1.0-pro-001 |
2024 年 2 月 15 日 | 2025 年 4 月 21 日 | gemini-2.0-flash |
gemini-1.0-pro-002 |
2024 年 4 月 9 日 | 2025 年 4 月 21 日 | gemini-2.0-flash |
gemini-1.0-pro-vision-001 |
2024 年 2 月 15 日 | 2025 年 4 月 21 日 | gemini-2.0-flash |
text-bison |
2023 年 5 月 | 2025 年 4 月 21 日 | gemini-2.0-flash-lite |
chat-bison |
2023 年 5 月 | 2025 年 4 月 21 日 | gemini-2.0-flash-lite |
code-gecko |
2023 年 5 月 | 2025 年 4 月 21 日 | gemini-2.0-flash-lite |
textembedding-gecko@002 |
2023 年 11 月 2 日 | 2025 年 4 月 21 日 | gemini-embedding-001 |
textembedding-gecko@001 |
2023 年 6 月 7 日 | 2025 年 4 月 21 日 | gemini-embedding-001 |