OpenAI 将于 2027 年 1 月下线九个 Audio 和 Realtime 模型 ID:运营商必须完成的迁移

OpenAI 于 7 月 20 日弃用九个遗留 audio、realtime 和 transcription 模型 ID,将于 2027 年 1 月 20 日下线。大多数情况下,迁移只需替换模型字符串,但路由 gpt-4o-audio、gpt-4o-realtime 和 gpt-audio 系列流量的运营商需要完成审计清单。

发布于 来源 OpenAI API

归档条目:由 AI 根据所引信源辅助生成,发布时未经逐篇审阅。责任编辑:Joe Werner。

清晰的路由决策树插图,将九个已弃用 audio 和 realtime 模型 ID 映射到 2027 年 1 月的替代版本,采用低饱和蓝灰色调

7 月 20 日,OpenAI 向所有在九个遗留 audio、realtime 和 transcription 模型 ID 上有活跃流量的开发者发送了弃用通知。下线时间:2027 年 1 月 20 日。这符合 OpenAI 对 GA 模型的六个月通知政策——窗口期已开启,但不会延期。

通知发布得相当低调。同一周内,新的 GPT Transcribe 和 GPT Live Transcribe 模型吸引了大量关注。但此次弃用影响的是更早期的一层架构:众多生产级语音和 audio 管道仍在直接调用的 gpt-4o-audio、gpt-4o-realtime、gpt-audio 和 gpt-realtime-mini 系列。

什么会下线以及时间节点

以下九个模型 ID 均于同一日期退场:

旧模型 ID推荐替代端点
gpt-realtimegpt-realtime-2.1v1/realtime
gpt-4o-realtimegpt-realtime-2.1v1/realtime
gpt-realtime-minigpt-realtime-2.1-miniv1/realtime
gpt-4o-mini-realtimegpt-realtime-2.1-miniv1/realtime
gpt-audiogpt-audio-1.5v1/chat/completions
gpt-4o-audiogpt-audio-1.5v1/chat/completions
gpt-audio-minigpt-audio-1.5v1/chat/completions
gpt-4o-mini-audiogpt-audio-1.5v1/chat/completions
gpt-4o-mini-transcribe-2025-03-20gpt-4o-mini-transcribe-2025-12-15v1/realtime/transcription_sessions

运营商影响:什么会崩溃,什么不会

所有迁移均无需变更端点。 Chat Completions(v1/chat/completions)上的 audio 输入/输出流量保持在相同端点——只需修改 model 字段。Realtime WebSocket session(v1/realtime)同理。这是一次模型字符串替换,不是重新集成。

下线后会出问题的情况:model 字段包含已弃用字符串的任何请求都将返回错误。如果你的 gateway 或应用硬编码了 gpt-4o-realtime 或 gpt-4o-audio,且在 1 月 20 日之前没有更新,这些调用将失败。

失败模式取决于你的路由如何处理模型错误。将错误返回给客户端的 gateway 会返回 4xx。有 model-not-found fallback 策略的 gateway 可能会静默路由到你并不想要的 fallback 模型。两种情况都是问题,但静默 fallback 更难排查——它不会表现为错误峰值,只会是意外的成本或行为变化。

三种场景的迁移路径

路径一:Chat Completions 带 audio 输出。 model 值为 ["gpt-audio", "gpt-4o-audio", "gpt-audio-mini", "gpt-4o-mini-audio"] 的均映射到 gpt-audio-1.5。gpt-audio-1.5 定价:文本 token $2.50/$10 per 1M,audio token $32/$64 per 1M——与当前 gpt-audio 价格表相同。上下文窗口(128K)和最大输出(16,384 token)也不变。

# 变更前
response = client.chat.completions.create(
    model="gpt-4o-audio",   # 2027 年 1 月 20 日弃用
    modalities=["text", "audio"],
    audio={"voice": "alloy", "format": "pcm16"},
    messages=[...]
)

# 变更后
response = client.chat.completions.create(
    model="gpt-audio-1.5",  # 替代版本
    modalities=["text", "audio"],
    audio={"voice": "alloy", "format": "pcm16"},
    messages=[...]
)

路径二:Realtime WebSocket session。 gpt-realtime、gpt-4o-realtime、gpt-realtime-mini、gpt-4o-mini-realtime 分别映射到 gpt-realtime-2.1 和 gpt-realtime-2.1-mini。gpt-realtime-2.1 定价:文本 token $4/$0.4/$24,audio token $32/$0.4/$64——与大多数团队已在运行的 GPT-Realtime-2 完全相同。Session API 契约不变:连接到 v1/realtime,在 session.update 事件中传入新的 model 字段即可。

路径三:Realtime transcription session。 唯一一个 snapshot 级别的迁移:gpt-4o-mini-transcribe-2025-03-20 → gpt-4o-mini-transcribe-2025-12-15。这是同一模型系列内的小版本升级,不涉及行为变更。为稳定性而锁定 2025 年 3 月 snapshot 的运营商,应在切换前测试 12 月 snapshot,特别关注语言检测准确率和轮次边界行为,因为 12 月版本包含更新的 VAD 校准。

路由器和 gateway 审计清单

如果你运行多模型 gateway 或路由器,迁移分三步:

  1. 在模型 ID 配置中搜索已弃用字符串。 别名(gpt-4o-realtime、gpt-audio)和你可能锁定的 snapshot 都需要找出来。使用弃用表中的完整列表,而不仅仅是你认为自己在使用的那些。

  2. 检查 audio 路由路径的 fallback 逻辑。 Realtime session 上的 model-not-found 错误在不同 gateway 实现中处理方式不同。部分实现会回退到 Chat Completions 路径,而这不是 WebSocket 语音 session 的有效替代。确保你的 realtime 路径错误处理要么硬失败,要么回退到另一个支持 v1/realtime 的模型——而不是 chat 模型。

  3. 验证替代 ID 的 rate limit 授权。 gpt-realtime-2.1 在各 tier 的 rate limit 与 GPT-Realtime-2 相同(从 Tier 1 到 5 分别为 200/400/5000/10000/20000 RPM)。但如果你的组织在某个旧模型 ID 上有自定义 rate limit 协议,请在切换前与 OpenAI 确认这些限制是否延续到新 ID。

跨 provider 视角:与其他 realtime audio API 的对比

OpenAI 的方式——六个月通知、端点不变、只改模型字符串——相对简洁。Gemini Live API 在处理模型版本过渡时采用了不同策略:部分版本迭代伴随端点路径变更,需要客户端重连逻辑而不只是配置更新。通过 DashScope 或类似推理 gateway 路由的 provider,有时在公开弃用通知下发之前就已影响成本计算。

2027 年 1 月的截止日期还与新 GPT Transcribe 和 GPT Live Transcribe 模型(7 月 28 日发布)预计大规模采用的时期重叠。此前使用 gpt-4o-mini-transcribe 进行同步文件转录的运营商,现在有两条迁移路径:使用新 snapshot(gpt-4o-mini-transcribe-2025-12-15)保持后向兼容,或迁移到本周推出的 gpt-transcribe/gpt-live-transcribe 更强大的转录专用架构。

TheRouter 用户现在应审计的内容

引用已弃用模型 ID 的任何路由配置都应在 2027 年 1 月前更新。实际截止时间应更早——12 月的节假日期间不是发现生产 audio 流量失败的好时机。

对于使用 TheRouter 并配置了 OpenAI audio provider 的团队,provider 设置中的 model-name 字段是首要审计点。在将路由表变更提交到生产环境之前,请在 staging 环境中测试替代模型 ID,尤其是对延迟敏感的 realtime session,因为连接建立时间至关重要。

帮助与联系