Google Gemini API官方更新记录显示,Imagen 4和Gemini 3 Image相关模型计划在2026年8月17日停用。本文资料核验日期为2026年8月14日,面向正在调用图像生成API的开发者,说明哪些模型需要排查、迁移前要保存什么,以及如何把新旧结果放进同一套回归流程。停用日期和可用模型以Google官方页面及你的账户控制台为准。

先看结论:今天就盘点模型ID,8月17日前完成小流量切换
先从代码仓库、环境变量、工作流配置和任务队列中搜索已弃用模型ID,再建立一组固定提示词与参考输入。迁移时优先选择Google弃用页面推荐的稳定或预览替代端点,逐项比较输出尺寸、风格一致性、错误处理和账单标签。
| 排查位置 | 需要保存 | 迁移后复核 |
|---|---|---|
| 服务端配置 | 模型ID、区域、参数和超时 | 新ID是否被所有环境加载 |
| 提示词与素材 | 提示词、参考图、负面约束 | 主体、构图和安全策略是否稳定 |
| 业务流程 | 队列、重试、人工审核规则 | 失败是否会重复扣费或阻塞任务 |
| 账单与监控 | 调用量、错误码、成本标签 | 新端点是否纳入告警和预算 |
哪些调用最容易被遗漏?

图片生成脚本与批处理任务
图片服务常把模型ID写在独立脚本、低代码节点或定时任务里。除了主应用,还要检查测试环境、备用队列和内容审核服务,避免只改一处导致部分请求继续失败。
别把“同一产品名”当作同一端点
Google弃用页面按具体模型ID和日期列出生命周期。产品名称相近并不代表请求参数、计费或输出协议相同,迁移前要打开目标模型页核对输入格式、分辨率、区域和访问方式。
参考结果要留在可复现环境
保存经过授权的参考图片、提示词版本、随机种子(如果目标端点支持)和人工验收记录。不要把含个人信息或客户素材的原图直接复制到公共测试项目。
8月17日前的五步迁移流程

- 搜索:在代码、配置和任务编排中检索弃用模型ID。
- 锁定样本:准备场景、文字、人物、产品和边界提示词。
- 选择端点:按官方弃用页面选择稳定或预览替代方案。
- 灰度切换:先让低风险任务走新端点,记录失败与人工修改。
- 收尾:更新文档、告警、预算和回滚开关,再撤下旧调用。
适用条件
- 你能读取项目配置、调用日志和模型生命周期页面。
- 业务有可保存的参考输入和人工验收标准。
- 涉及客户素材时,测试项目已完成权限和数据分级。
限制与风险
- 官方停用时间可能按服务、地区或账户显示不同。
- 新模型不保证逐像素复现旧结果,迁移需要重新校准提示词。
- 预览端点可能改变协议,生产环境应锁定版本并保留回滚。
FAQ
8月17日后旧模型还能临时调用吗?
不能把临时可用当成计划依据。官方页面已给出停用时间,重要任务应在截止日前完成切换和验证。
只改模型名称就够了吗?
不够。参数、分辨率、权限、错误码、账单和内容安全设置都可能需要同步检查。
如何判断迁移结果可接受?
为每类任务设定可观察标准,例如主体完整、文字可读、尺寸符合页面要求、审核通过率和人工修改时间。
