跳到主要内容

弃用与迁移观察

进阶

模型会被退役，参数会被重命名，行为会发生变化。本页追踪 破坏性变更，让升级不会让你措手不及。如果你基于 API 进行构建，请定期浏览本页。

为什么这很重要​

一个被固定的模型 ID 终将被 弃用，进而被 移除。硬编码该 ID 的代码会出问题。一点点保养就能避免凌晨两点的意外。

生存法则​

  • 从配置中读取模型 ID，绝不要在整个代码库中散布字面量——这样迁移就只是改动一行。
  • 关注公告，留意弃用日期和推荐的替代方案。
  • 切换模型时，重新运行你的 评估——即使是在“更新、更好”的模型上，行为也可能发生变化。
  • 在截止日期之前测试，而不是在移除之后。

常见的变更类型​

变更示例应对方式
模型退役某个较旧的模型 ID 停止工作迁移到推荐的后继模型；重新评估
参数被取代某个推理/预算旋钮被 effort 取代更新调用；参阅 思考与 Effort
默认值变更新的默认模型/行为有意识地固定版本；验证你的提示词是否仍然有效
端点/SDK 更新新的 SDK 主版本阅读迁移指南；谨慎升级

当前观察​

种子内容——随着真实、有来源的弃用通知发布，请替换为它们。

  • 对照 当前模型与定价 表格确认你的模型 ID；如果你仍在使用较旧的 ID，请规划一次迁移。
  • 此处尚未记录其他破坏性变更。请追踪 官方模型文档 获取权威的时间表。

下一步​