OpenAI 弃用生命周期指南：通知期、关停日历与迁移清单

OpenAI 的模型与 API 退役不是随机的：官方用一套明示的生命周期管理它——公告弃用、给出关停日、承诺最低通知期、每批对象给出推荐替代。本文把官方弃用页（Deprecations）的规则拆开讲清楚：三个关键概念的区别、通知期的官方下限、真实案例的时间线校准，以及一份可以直接抄进团队的迁移清单。所有规则与日期均引自官方弃用页与 changelog（2026-09-01 核对）。

1. 三个概念：deprecation、shut down、legacy

官方弃用页对这三个词有明确区分：

• deprecation（弃用）：官方公告某个模型或端点进入退役流程的瞬间，它立即成为弃用状态。每个弃用对象都必然附带一个关停日期。
• shut down / sunset（关停）：官方明确这两个词是同义词，都指模型或端点不再可访问。到了关停日，调用直接失败。
• legacy（遗留）：不再接收更新的模型或端点。官方用它标注平台迁移方向——legacy 对象未来大概率会被正式弃用，但当下仍可用。

对工程实践的含义：看到 legacy 就该排迁移计划，看到 deprecated 就必须有关停日倒计时，到了 shut down 一切为时已晚。 Chat Completions（messages 字段）目前就处于 legacy 阶段——官方口径是新项目用 Responses API。

2. 通知期：官方承诺的下限

官方为不同类型的模型设定了最低通知期（除非安全或合规原因需要更快的时间线）：

三条配套规则同样重要：

1. 安全或合规优先：如果安全或合规原因要求更快退役，官方会尽可能提前通知，但不受上表约束。
2. preview 不是生产档：官方明确不建议把 preview 模型用于业务关键的生产负载——除非你具备短通知期内迁移的能力。
3. 关停后有条件续命：某些情况下可以联系销售申请专属容量（dedicated capacity），在关停日后继续访问旧模型。这是商务路径，不是自助开关。

通知的触达方式：官方会邮件通知正在活跃使用该模型的客户，并在弃用页记录；更大的变化还会配博客文章。

3. 用真实案例校准时间直觉

规则是下限，真实批次落在哪？四个已经走完或正在走完周期的案例：

两个观察：一是官方实际执行几乎都贴着下限走——6 个月就是 6 个月，3 个月就是 3 个月，不要指望"平均会宽一些"；二是专项变体的 3 个月档真实存在且被严格执行，用 chat-latest 这类别名做生产集成的团队要格外留意。

4. 当前关停日历（2026-09 至 2027-02）

把官方弃用页所有未到期批次按日期排（2026-09-01 核对），未来六个月的硬节点：

这份日历会持续变动，权威来源始终是官方弃用页；本站每周速报也会跟踪增删，最新一期见 《OpenAI 生态第 43 周速报（2026-09-01）：mTLS 正式可用 / Sora 2 关停倒计时 / 秋冬关停日历》。

5. 迁移五步清单

第一步，盘点调用面。从弃用页整理本批次的模型名清单，在代码与配置里全局搜索：

#!/usr/bin/env bash
# 把官方弃用页本批次的模型名放进 models.txt（每行一个）
# 在所有代码与配置目录里搜一遍
for m in $(cat models.txt); do
  grep -rn --exclude-dir=node_modules --exclude-dir=.git "$m" \
    ~/projects ~/infra 2>/dev/null
done

第二步，映射官方替代。按弃用页每行的 Recommended replacement 建映射表，收敛到统一配置层，而不是散落在各处硬编码：

# model_map.py —— 集中管理模型别名，弃用迁移只改这一个文件
MODEL_ALIASES = {
    # 2026-12-11 关停批次（官方替代建议）
    "gpt-5-2025-08-07": "gpt-5.6-sol",
    "gpt-5-mini-2025-08-07": "gpt-5.6-terra",
    "gpt-5-nano-2025-08-07": "gpt-5.6-luna",
    "o3-2025-04-16": "gpt-5.6-sol",
}

def resolve(model: str) -> str:
    return MODEL_ALIASES.get(model, model)

第三步，小流量替换。先在非核心链路切到替代模型，观察输出质量、延迟、成本三项。调用本身用 Responses API 的 input 字段，模型名只是参数之一：

from openai import OpenAI

client = OpenAI()
resp = client.responses.create(
    model=resolve("o3-2025-04-16"),  # 解析为 gpt-5.6-sol
    input="总结这份合同的付款条款",
)
print(resp.output_text)

第四步，回归对比。固定测试集跑新旧两版，重点核对结构化输出格式、工具调用行为与边界输入——替代模型换了代际，提示词可能需要微调。

第五步，观察残留流量。到 Platform 控制台的 Usage 面板按模型与 API key 维度观察一至两周（面板与 Usage API 自 2026-08-04 起都支持 API key 维度），确认旧模型流量归零，再把关停日设为日历提醒兜底。

6. 常见错误与排查

• 把 legacy 当安全：legacy 只是不再更新，弃用公告随时可能来。Chat Completions 处于 legacy 阶段就是前车之鉴——新项目直接上 Responses API。
• 用 preview 模型扛生产：preview 的通知期可能只有约 2 周，官方自己都不建议；生产负载要么用 GA 模型，要么准备好两周内迁移的预案。
• 只搜代码库不搜基础设施：模型名经常藏在 Terraform、Helm values、CI 脚本、同事的 notebook 里。第 5 节的盘点命令应该对整个基础设施目录跑。
• 忽略替代栏为空的批次：没有官方替代建议（如 Sora 2 批次）不代表可以不迁移，只代表迁移方案要自己负责。
• 把 ChatGPT 产品侧退役套到 API 上：产品侧惯例是继任者上线后约 90 天退役，与 API 弃用时间表不同步，两套日历分开管。

7. 下一步

• 官方规则原文：OpenAI Deprecations（本文所有规则与日期的来源）。
• 2026 下半年更新的时间线视角：OpenAI 2026 下半年模型与 API 更新时间线。
• Responses API 与 Chat Completions 的取舍：Responses API vs Chat Completions：该迁移了吗。
• 模型替代映射的选型依据：《GPT 模型完全指南（2026-07）：GPT-5.6 Sol / Terra / Luna 选型》。