Gemini API 图片模型迁移：停用前样本对照与切换

变更范围与交付标准

发布说明会区分弃用、关闭和可继续服务等状态。在官方生命周期或发布记录中登记旧模型 ID、状态、公告日期、计划关闭日期与当前调用位置。资料包显示，部分 Imagen 4 图像生成模型被公告弃用并计划关闭；替代端点应以使用当日官方弃用页面和模型文档为准，不要把未验证的候选端点直接写进生产配置。

固定成图样本

在旧端点仍可调用时，建立一份不可改写的样本表。每条样本保留提示词原文、参考图文件、请求配置、生成时间、结果文件和人工判定。样本不要只选容易成功的图，应覆盖主力生产任务和曾经返工的案例。

• 主体一致性：商品外形、角色特征或关键物件是否保留。
• 文字风险：画面是否出现不需要的文字、乱码或错误标识。
• 构图要求：主体位置、留白、镜头角度和画幅是否符合用途。
• 输出要求：实际文件是否满足团队约定的规格并可被后续系统读取。

候选端点对照测试

1. 复制旧请求的业务输入，固定提示词、参考图、输出用途和验收规则。
2. 仅把调用配置切到候选端点；若候选端点不支持原有字段，单独记录差异，不要悄悄删除。
3. 为每个样本生成可比较的候选结果，并按样本编号归档。
4. 由至少一名熟悉业务素材的人按同一标准判定通过、需修改或失败。
5. 汇总失败类型，确认是输入兼容问题、能力差异还是应用侧保存与解析问题。

商品主图对照示例

例如，一条样本要求生成浅色背景中的单个产品，主体居中，右侧保留排版空间，不生成文字。旧结果和候选结果都应放入同一张对照表：先看产品外形和材质，再看主体是否侵占留白，最后检查是否出现多余文字。候选结果即使视觉更好，只要文件规格或主体识别不符合交付要求，也应标为未通过，并注明需要调整的提示词或应用处理环节。

故障定位与修正

切换记录与上线验收

回退记录至少包含切换时间、旧配置、候选配置、通过样本数、已知限制、负责人和停止条件。若旧端点仍处于可用窗口，可将少量非关键任务先切到候选端点；若旧端点已关闭，则应保留已验证的请求适配版本与失败样本，避免临时改动造成无法复现的问题。

• 已核对旧模型的生命周期状态与关闭时间。
• 固定提示词、参考图和旧结果已归档。
• 候选端点已完成主体、文字、构图和输出规格检查。
• 请求失败、响应解析和文件保存均有日志可查。
• 不兼容字段和人工处理步骤已写入交接记录。
• 切换负责人、回退条件和异常处置人已明确。
• 生产配置变更前已在测试环境完成复测。