OpenAI GPT-5 与 O3 快照下线指南：2026 年 12 月迁移规划

2026 年 6 月 11 日，OpenAI 宣布弃用并移除六个初代 GPT-5 和 O3 模型快照。关停日期为 2026 年 12 月 11 日——距今约 175 天。如果你的代码库中固定引用了这些带日期戳的模型 ID，你需要一份迁移计划。不是 11 月再想的提醒——而是现在就测试和验证的计划，趁还有时间发现回归问题。

本指南提供精确的替换映射、前后代码 diff、价格变动分析、回滚策略和生产检查清单。我们也会说明这次下线如何与 Anthropic 的弃用节奏以及国内供应商下线共同构成 2026 年的整体弃用版图。

我们通过已配置的供应商路由 OpenAI 兼容请求，并在产品路径支持的范围内提供供应商/模型路由和 fallback。我们不声称支持所有模型、零停机或保证最低价格。以下所有日期和价格数据均来自 OpenAI 官方文档，获取时间为检索时。

30 秒速览

• 弃用公告日期： 2026 年 6 月 11 日（OpenAI Deprecations，检索于 2026-06-20）。
• 关停日期： 2026 年 12 月 11 日。此日期之后，对这些模型 ID 的 API 请求将返回错误。
• 受影响模型： 6 个快照——gpt-5-2025-08-07、gpt-5-mini-2025-08-07、gpt-5-nano-2025-08-07、gpt-5-pro-2025-10-06、o3-2025-04-16 和 o3-pro-2025-06-10。
• 推荐替代： GPT-5.5 系列（gpt-5.5、gpt-5.4-mini、gpt-5.4-nano、gpt-5.5-pro）。
• 通知期限： 6 个月——符合 OpenAI 对正式发布模型的政策。
• 现在需要做的： 审计代码库中固定的快照 ID，开始影子测试替代模型，不要等到 11 月。

完整模型替换矩阵

下表列出每个受影响的模型、关停日期和 OpenAI 推荐的替代方案。所有数据来自 OpenAI Deprecations 页面，检索于 2026-06-20。

关键模式： O3 推理系列并入 GPT-5.5 家族。OpenAI 已将推理和通用目的产品线统一——不再有独立的 "o-series" 替代。

前后代码对比：更新模型 ID

Python SDK (openai >= 1.x)

迁移前——固定引用弃用快照：

from openai import OpenAI

client = OpenAI()

response = client.chat.completions.create(
    model="gpt-5-2025-08-07",  # ← 已弃用，12 月 11 日关停
    messages=[
        {"role": "user", "content": "解释路由 fallback 模式"}
    ]
)

迁移后——使用替代模型：

from openai import OpenAI

client = OpenAI()

response = client.chat.completions.create(
    model="gpt-5.5",  # ← 推荐替代
    messages=[
        {"role": "user", "content": "解释路由 fallback 模式"}
    ]
)

O3 推理模型迁移

# 迁移前——O3 快照
response = client.chat.completions.create(
    model="o3-2025-04-16",  # ← 已弃用
    messages=[{"role": "user", "content": "请逐步解决..."}]
)

# 迁移后——GPT-5.5（统一推理 + 通用能力）
response = client.chat.completions.create(
    model="gpt-5.5",  # ← 替代模型
    messages=[{"role": "user", "content": "请逐步解决..."}]
)

Node.js / TypeScript

// 迁移前
const response = await openai.chat.completions.create({
  model: "gpt-5-pro-2025-10-06",  // ← 已弃用
  messages: [{ role: "user", content: "..." }],
});

// 迁移后
const response = await openai.chat.completions.create({
  model: "gpt-5.5-pro",  // ← 替代模型
  messages: [{ role: "user", content: "..." }],
});

cURL

# 迁移前
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model": "o3-pro-2025-06-10", "messages": [...]}'

# 迁移后
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{"model": "gpt-5.5-pro", "messages": [...]}'

价格影响：旧快照 vs. 替代模型

弃用快照当前仍按原始费率计费。迁移后价格转为替代模型的定价层级。下表对比 GPT-5.5 系列当前定价（OpenAI API Pricing，检索于 2026-06-20）。

成本考量：

• gpt-5 → gpt-5.5： GPT-5.5 旗舰版定价 $5/$30（输入/输出）。如果你之前使用原始 GPT-5 快照定价，预计会有适度上涨，反映能力提升。
• gpt-5-mini → gpt-5.4-mini： $0.75/$4.50 的 mini 层级仍是延迟敏感工作负载最具性价比的选择。
• o3 → gpt-5.5： O3 推理快照迁移到 GPT-5.5，定价 $5/$30。如果你之前支付 O3 推理层级的溢价，这可能简化了定价结构——但请根据实际用量验证。
• gpt-5-pro / o3-pro → gpt-5.5-pro： 专业层级 $30/$180 是高级推理选项。如果依赖深度推理，请相应调整预算。

使用 prompt caching 来降低有效输入成本——GPT-5.5 的缓存 token 便宜 90%。

注意事项：快照版本间的行为变化

将固定快照替换为 "latest" 模型会引入潜在的行为漂移。注意以下几点：

1. 输出风格差异。 GPT-5.5 对同一 prompt 的响应长度和风格可能与 gpt-5-2025-08-07 不同。切换生产流量前先跑评估套件。

2. 推理模式统一。 O3 系列专为链式思考推理设计。GPT-5.5 吸收了此能力，但处理 reasoning_effort 参数的方式可能不同。对推理密集型 prompt 进行显式测试。

3. token 计数变化。 GPT-5.5 的 tokenizer 可能与 GPT-5 快照 tokenizer 略有不同。如果有严格的 token 预算逻辑，请验证计数。

4. 速率限制。 速率限制按模型系列计算。从快照迁移到当前模型可能使你进入不同的速率限制层级。切换后检查组织速率限制。

5. 微调模型依赖。 如果你在任何弃用基础模型上进行了微调，这些微调变体也将在同一日期停止工作。

回滚路径：在测试窗口期间固定版本

你有直到 2026 年 12 月 11 日的时间来测试。善用这个窗口：

1. 影子路由。 将一部分流量发送到替代模型，同时继续使用弃用快照提供服务。对比输出。

2. A/B 评估。 对两个模型运行评估套件。标记质量回归。

3. 分阶段上线。 通过评估后，在 2-4 周内按 10% → 50% → 100% 逐步上线。

4. 固定到 GPT-5.5 特定快照。 当 OpenAI 发布快照版本（如 gpt-5.5-2026-XX-XX）时，固定引用以获得行为稳定性。

5. fallback 配置。 配置 fallback 链：主用 gpt-5.5 → 备用 gpt-5.4 → 备用 gpt-5.4-mini。如果替代模型出现故障或质量回归，流量自动切换。

2026 年 OpenAI 弃用全景

12 月 11 日 GPT-5/O3 关停是更大弃用浪潮的一部分。以下是 2026 年底前 OpenAI 模型下线的完整时间线：

数据来源：OpenAI Deprecations，检索于 2026-06-20。

关键结论： 如果你还在使用 GPT-3.5 Turbo、GPT-4 或 GPT-4 Turbo——它们在 2026 年 10 月 23 日关停，早于 GPT-5/O3 快照。应一并规划两次迁移。

跨供应商弃用背景

OpenAI 12 月 2026 的关停并非孤立事件。运行多供应商技术栈的团队面临同期的弃用浪潮：

• Anthropic： Claude 模型在通知后约 60 天内弃用。参见我们的 Anthropic 弃用迁移指南。
• 国内供应商（DashScope、火山引擎、智谱）： 多个下线波次在 2026 年 7-9 月。参见我们的国内 AI 模型弃用日历。
• Azure OpenAI (Microsoft Foundry)： Azure 退役时间与 OpenAI 模型 ID 一致，但具体日期可能不同。请查看 Azure 模型退役计划。

TheRouter 集成：OpenAI 模型迁移的路由和 fallback

TheRouter 通过已配置的供应商路由 OpenAI 兼容请求，并在产品路径支持的范围内提供供应商/模型路由和 fallback。对于管理此次迁移的团队：

• 模型 ID 别名。 在路由层配置弃用模型 ID 到替代模型的映射。当弃用快照关停时，流量自动路由到替代模型，无需客户端代码变更。
• fallback 链。 设置 gpt-5.5 → gpt-5.4 → gpt-5.4-mini 作为 fallback 链。如果主模型不可用或超出速率限制，请求优雅降级。参见我们的 LLM API fallback 路由指南。
• 统一计费。 通过统一计费和账务平面跟踪模型迁移前后的成本变化。

完整的迁移演练请参见我们的 OpenAI 到 TheRouter 迁移指南。

1. 替换三个值，不是三个 SDK。在现有 OpenAI 客户端里改 api_key、base_url、model。请求与响应代码保持不变。
2. 显式映射 model ID。目标供应商的 model id 几乎不会和 OpenAI 完全一致。 在业务代码之外维护一份 { openai_id: target_id } 映射。
3. 验证流式格式。SSE 分片必须遵循 OpenAI 的 data: {...} + data: [DONE] 契约。切生产前先跑一次流式调用。
4. 检查限流响应头。部分供应商不返回 x-ratelimit-*。 在包装层 做缺省兜底，缺头不要崩。
5. 留回滚路径。用 feature flag 切流；新旧 endpoint 影子并行 24 小时，再正式切换。

生产检查清单

迁移截止日期前请使用此清单：

• 审计固定的模型 ID。 搜索代码库中的 gpt-5-2025、gpt-5-mini-2025、gpt-5-nano-2025、gpt-5-pro-2025、o3-2025、o3-pro-2025。同时检查环境变量、配置文件和基础设施即代码模板。
• 检查微调模型。 如果在任何弃用基础模型上进行了微调，这些微调变体在同一日期关停。
• 运行评估套件。 对比替代模型输出与当前基线。标记质量、延迟或 token 用量的回归。
• 测试 prompt caching。 GPT-5.5 支持 $0.50/百万缓存 token 的 prompt caching（九折优惠）。实施它以抵消成本上涨。
• 验证速率限制。 检查组织在替代模型层级的速率限制。
• 设置 fallback。 配置 fallback 链，确保应用在替代模型出问题时优雅降级。
• 安排分阶段上线。 在 12 月 11 日前至少 30 天计划 10% → 50% → 100% 的上线。
• 监控迁移后状态。 完全上线后 2 周内跟踪错误率、p95 延迟和用户满意度。
• 移除弃用模型引用。 成功迁移后，清理引用弃用模型 ID 的死代码。
• 设置日历提醒。 2026 年 10 月 23 日——GPT-3.5/GPT-4/O4-mini 关停。如果你也使用这些模型，需一并规划迁移。

常见问题

Q: 2026 年 12 月 11 日之后还能使用弃用的快照吗？ A: 不能。关停日期之后，对这些模型 ID 的 API 请求将返回错误。OpenAI 在某些情况下提供专用容量选项以延长访问——如果有硬性依赖，请联系其销售团队。

Q: GPT-5.5 的行为会和 gpt-5-2025-08-07 完全一致吗？ A: 不会。GPT-5.5 是更新的模型，具有更强的能力。输出质量、风格和 token 用量会有差异。迁移生产流量前务必测试。

Q: Azure OpenAI 部署怎么办？ A: Azure 模型退役通常跟随 OpenAI 的时间表，但具体日期可能不同。请查看 Azure 模型退役页面。

Q: 我在使用 O3 做推理任务。GPT-5.5 支持相同的推理功能吗？ A: GPT-5.5 吸收了 O3 的推理能力。支持 reasoning_effort 参数和链式思考行为，但实现可能有差异。请对推理密集型工作负载进行显式测试。

Q: 迁移后发现质量回归怎么办？ A: 回滚到弃用快照（在 12 月 11 日前仍可用），向 OpenAI 提交回归报告，并调查是否通过 prompt 调整或选择不同的替代模型（如用 gpt-5.4 替代 gpt-5.5）可以解决问题。

---

所有弃用日期和价格来自 OpenAI Deprecations 和 OpenAI API Pricing，检索于 2026-06-20。模型能力和行为可能变化。做出生产决策前请核对官方文档。