Google Text & Gemini Embeddings (004 / Gecko) 弃用状态、停服日期与迁移指南
追踪 Google Text & Gemini Embeddings (004 / Gecko)(Google)在 Google Gemini, Google Vertex AI 中已确认的 UTC 弃用与停服日期。可在下方本地预览 text-embedding-004 → gemini-embedding-001 升级替换差异,前往模型配置审计工具扫描完整配置,或在 DevToken 测算调用成本。
1. 快速 .env 与 SDK 配置替换匹配器
在下方编辑或粘贴你的 .env 变量赋值、LiteLLM 路由条目或 SDK 模型标识符,即可在浏览器本地实时检测三态 EOL 状态并一键复制可直接应用的替换 diff。
替换差异预览(text-embedding-004 → gemini-embedding-001)
# VERTEX_MODEL: text-embedding-004 -> gemini-embedding-001 [DEPRECATED · EOL 2027-04-01]
- VERTEX_MODEL="text-embedding-004"
+ VERTEX_MODEL="gemini-embedding-001"
# GEMINI_MODEL: gemini-embedding-001 -> gemini-embedding-2 [DEPRECATED · EOL 2028-05-14]
- GEMINI_MODEL="gemini-embedding-001"
+ GEMINI_MODEL="gemini-embedding-2"
2. 跨生态 Google Text & Gemini Embeddings (004 / Gecko) 生命周期矩阵(18)
厂商直连 API 与各大云托管平台按各自独立的时间表下线日期快照。请在下方核对与你生产环境完全一致的模型 ID、厂商阶段标签及 UTC 停服日期。
| 模型 ID | 提供商 | 计算状态 | 确认停服日期(UTC) | 厂商原始阶段 | 替代模型与迁移 | 来源 |
|---|---|---|---|---|---|---|
multimodalembedding@001 |
Google Vertex AIGemini Models | 已弃用(140 天) | 2027-04-01140 天后 | Deprecated | 文档 ↗ | |
text-embedding-004 |
Google Vertex AIGemini Models | 已弃用(140 天) | 2027-04-01140 天后 | Deprecated | 文档 ↗ | |
text-embedding-005 |
Google Vertex AIGemini Models | 已弃用(140 天) | 2027-04-01140 天后 | Deprecated | 文档 ↗ | |
text-multilingual-embedding-002 |
Google Vertex AIGemini Models | 已弃用(140 天) | 2027-04-01140 天后 | Deprecated | 文档 ↗ | |
gemini-embedding-001 |
Google Gemini | 已弃用(549 天) | 2028-05-14549 天后 | Deprecated | 文档 ↗ | |
gemini-embedding-2-preview |
Google Gemini | 已停服 | 2026-11-066 天前 | Retired | 文档 ↗ | |
text-embedding-004 |
Google Gemini | 已停服 | 2026-01-14302 天前 | Retired | 文档 ↗ | |
embedding-001 |
Google Gemini | 已停服 | 2025-10-30378 天前 | Retired | 文档 ↗ | |
embedding-gecko-001 |
Google Gemini | 已停服 | 2025-10-30378 天前 | Retired | 文档 ↗ | |
gemini-embedding-exp |
Google Gemini | 已停服 | 2025-10-30378 天前 | Retired | 文档 ↗ | |
gemini-embedding-exp-03-07 |
Google Gemini | 已停服 | 2025-10-30378 天前 | Retired | 文档 ↗ | |
textembedding-gecko-multilingual@001 |
Google Vertex AIGemini Models | 已停服 | 2025-05-24537 天前 | Retired | 文档 ↗ | |
textembedding-gecko@003\* |
Google Vertex AIGemini Models | 已停服 | 2025-05-24537 天前 | Retired | 文档 ↗ | |
textembedding-gecko@001 |
Google Vertex AIGemini Models | 已停服 | 2025-04-21570 天前 | Retired | 文档 ↗ | |
textembedding-gecko@002 |
Google Vertex AIGemini Models | 已停服 | 2025-04-21570 天前 | Retired | 文档 ↗ | |
gemini-embedding-2 |
Google Gemini | 正常可用 | 无 EOL | Active | — | — |
gemini-embedding-001 |
Google Vertex AIGemini Models | 正常可用 | 无 EOL | Active | — | — |
gemini-embedding-2 |
Google Vertex AIGemini Models | 正常可用 | 无 EOL | Active | — | — |
3. 生产环境迁移核查清单(text-embedding-004 → gemini-embedding-001)
在生产服务与 SDK 客户端下线固定模型快照前,建议遵循以下确定性工程步骤完成验证:
- 盘点已固定的模型 ID:全局检索代码库与部署清单中的
GEMINI_MODEL、LiteLLMgemini/路由及 Google Text & Gemini Embeddings (004 / Gecko) 家族快照字符串(当前追踪 5 项弃用、10 项停服、3 项可用)。 - 评估继任模型质量与 Token 单价:在
gemini-embedding-001上验证结构化输出 Schema、工具调用载荷与响应延迟,并在 DevToken 中对比输入、输出与缓存命中费率。 - 接入免密钥 CI 门禁保护:将 RSS、Atom、iCal 订阅源与 CI 守卫接入合并请求检查,防止已停服或已弃用的 Google Text & Gemini Embeddings (004 / Gecko) 标识符重新流入生产分支。
4. 相关 Google 与跨生态迁移指南
对比同系列相邻模型家族,或查看托管该家族的各大生态完整生命周期时间表:
Gemini 1.5 Pro
已停服Gemini 1.5 Flash
已停服Gemini 2.5 Pro
已弃用(5 天)Gemini 2.5 Flash & Flash-Lite
已弃用(5 天)5. Google Text & Gemini Embeddings (004 / Gecko) 弃用与升级常见问题
Google Text & Gemini Embeddings (004 / Gecko) 在 Google Gemini, Google Vertex AI 中是否已被弃用或停服?
LLMEOL 在 Google Gemini, Google Vertex AI 中共追踪 18 个 Google Text & Gemini Embeddings (004 / Gecko) 变体,其中 5 个处于已公布停服计划的已弃用状态,10 个已超过 UTC EOL 日期并停服,3 个正常可用且未公布停服日期。请查阅上方跨生态矩阵了解各快照的精确日期。
从 text-embedding-004 迁移时推荐升级到哪个替代模型?
text-embedding-004 的首选推荐升级目标为 gemini-embedding-001。在切换生产流量前,请务必在 gemini-embedding-001 上回归测试提示词格式、最大输出长度与工具调用结构,并在 DevToken 中对比 Token 计费成本。
如何安全替换 .env 与 LiteLLM 配置文件中的 text-embedding-004?
将你的 GEMINI_MODEL 赋值语句或 LiteLLM 模型配置块粘贴至本页的快速替换匹配器即可生成精确 diff,或打开完整本地模型配置审计工具在零网络上传的前提下扫描多服务配置文件。