OpenAI gpt-image-2 API 迁移指南：gpt-image-1、gpt-image-1.5 与 chatgpt-image-latest

2026 年 6 月 2 日，OpenAI 宣布 gpt-image-1-mini 弃用，同时被列入停服计划的还有 gpt-image-1.5 和 chatgpt-image-latest，三者的停服日期均为 2026 年 12 月 1 日。如果你的路由配置或异步媒体 pipeline 中仍然引用了这些 model ID，现在距停服还有约六个月时间迁移至 gpt-image-2。本文是面向 API 运营商的路由迁移指南，涵盖变更内容、潜在的断点，以及在停服前需要处理的操作项。

OpenAI 弃用了哪些模型

本次 6 月 2 日的弃用通知涉及三个图像生成 model ID：

此外，基础版本 gpt-image-1 已在 4 月 22 日的弃用波中被列入，停服日期为 2026 年 10 月 23 日。这意味着 gpt-image-1 系列的所有变体都将在 2026 年第四季度完全退出，届时 OpenAI 唯一支持的图像生成 API 只有 gpt-image-2。

为什么这对路由和异步 pipeline 有影响

与文本模型的迁移不同，图像模型的切换涉及几个路由层面的关键问题：

1. 路由配置中的 model alias 解析

如果你的 gateway 或 router 将 gpt-image-1-mini 硬编码为 model alias 或 fallback 目标，12 月 1 日之后的调用将直接返回错误。如果 provider 层没有针对 model-not-found 错误的告警，这是一个容易被忽略的静默故障模式。

2. 计费单位与配额变化

gpt-image-2 的定价结构与前代产品不同：按图像计费，并根据分辨率分级定价，而非基于 token 数量。如果你的路由策略中存在依赖 per-token 成本估算的预算门控逻辑，迁移后将产生错误的成本预估。

3. 异步任务模式兼容性

对于通过异步任务队列运行图像生成的团队——常见于批量渲染、商品图录 pipeline 或内容自动化——需要验证队列处理器是否能正确处理 gpt-image-2 的响应格式。TheRouter 的异步媒体平台已通过统一 v2 任务接口路由 gpt-image-2；调度与轮询合约详见 TheRouter v2.0 统一异步媒体平台。

4. chatgpt-image-latest alias 的风险

chatgpt-image-latest 是一个 alias，而非固定快照版本。将其作为便捷指针的运营商可能没有意识到：这次是完全停用，而非重定向到 gpt-image-2。与大多数 latest alias 弃用不同，它不会自动前向指向新模型，12 月 1 日之后该 alias 将直接失效。

如何在路由策略中将 gpt-image-1-mini 迁移至 gpt-image-2

请按以下清单在 2026 年 12 月 1 日前完成迁移，同时也是如何在路由策略中将 gpt-image-1-mini 迁移至 gpt-image-2 的操作参考：

1. 审查模型引用。 在路由配置、SDK 调用点以及所有硬编码的 model 字符串中搜索 gpt-image-1-mini、gpt-image-1.5、chatgpt-image-latest 和 gpt-image-1。最后一个的停服日期更早（10 月 23 日）。

2. 更新 fallback 链。 如果 gpt-image-1-mini 作为 gpt-image-1.5 或 gpt-image-2 后的低成本 fallback 存在，建议直接删除整个链路，统一指向 gpt-image-2。在 fallback 位置继续保留弃用模型只会推迟迁移，同时降低可观测性。

3. 重新验证预算门控。 gpt-image-2 的定价层次（低 / 中 / 高质量 × 分辨率）与 gpt-image-1-mini 的标准 / HD 定价体系不同。如果路由策略基于单次请求成本进行门控判断，需要更新成本估算。

4. 验证响应格式一致性。 gpt-image-2 以相同的 Images API 格式返回 base64 编码图像数据，但需验证下游消费者是否能正确处理你 pipeline 中依赖的质量层次或尺寸差异。

5. 设置迁移截止提醒。 在 2026 年 10 月 1 日（停服前两个月）设置一个检查节点，若 gpt-image-1-mini 或 gpt-image-1.5 仍出现在活跃路由路径中，强制触发迁移评审。

6. 考虑非 OpenAI provider 的长尾 fallback。 对于需要在规模化场景下进行成本优化图像生成、并在评估替代方案的团队，可以测试以 provider 无关的 fallback（如 Qwen-Image-2.0 或 Vertex 上的 Imagen 3）作为冷备用。

gpt-image-2 的能力提升

迁移前，了解 gpt-image-2 相比弃用模型的主要差异：

• 通过 edits endpoint 支持 inpainting 和 outpainting — gpt-image-1-mini 不具备此能力
• 中等质量下的有效分辨率高于 gpt-image-1.5 的 HD 档
• 对包含多目标的复杂提示词，指令遵循能力更强
• 输出内嵌 C2PA 来源元数据（对于内容治理 pipeline 有直接意义）

整体而言，此次迁移是能力升级而非平移，但定价模式的变化需要运营商提前了解。

时间线汇总

从今天起，12 月 1 日停服还有约 26 周。考虑到企业通常在 Q3 和 Q4 存在变更冻结窗口，实际可用的工作时间更短，建议现在开始着手。

TheRouter 用户的操作建议

如果你通过 TheRouter 路由图像生成请求，请在路由规则或 provider 配置中，将 gpt-image-1-mini 和 gpt-image-1.5 替换为 gpt-image-2。异步媒体资源交付文档涵盖了通过 TheRouter 进行图像生成的完整任务生命周期，包括如何处理停服后将替代成功响应的 provider 层错误。