Gemini Live与TTS预览模型11月17日退役，迁移指南

Google 的 Gemini API 正在清理一批预览阶段的模型。根据官方公告，两个 Live API 预览模型和三个 TTS 预览模型将于 2026 年 11 月 17 日正式关停。对于正在使用这些模型构建实时语音交互或语音合成功能的开发者来说，这是一次必须提前处理的迁移。

哪些模型将被退役？

本次退役涉及两类模型：Live API 预览版和 TTS 预览版。Live API 用于支持低延迟的实时音视频交互，而 TTS 则负责文本转语音输出。公告中明确列出了两个 Live 预览模型和三个 TTS 预览模型，它们将在截止日期后停止服务。

虽然原文未逐一列出完整的模型 ID，但开发者可以在 Gemini API 的模型版本页面核对当前使用的模型标识符是否在退役清单中。关键点在于：这些模型带有“preview”标签，意味着它们从未获得正式版的稳定性承诺，生命周期本就有限。

Live API 是 Gemini API 中面向实时双向交互的接口，基于 WebSocket 或 WebRTC 长连接，让模型持续接收音频/视频流并即时返回语音响应，典型用例包括语音助手、实时翻译和客服机器人。它不同于普通的单次请求-响应调用，会话状态在连接期间持续存在，因此会话初始化参数（如音频采样率、语音活动检测阈值、上下文截断策略）对体验影响很大。TTS（Text-to-Speech） 则是将文本转为语音的接口，开发者可指定音色、语速和输出音频格式。Gemini 的 TTS 预览模型在命名上带有 preview 后缀，表示其 API 契约和模型行为仍可能变动，Google 通常不为其提供正式版 SLA，且可能随时宣布退役——这正是本次迁移的根源。

替代方案：Gemini 3.8 Live 与 3.8 Flash TTS

退役之后，官方指定的迁移路径是 Gemini 3.8 Live 和 Gemini 3.8 Flash TTS。从命名可以看出，新模型在版本号上实现了跨越，并且 Flash 系列通常意味着更低的推理延迟和更高的吞吐效率。

对于 Live API 用户，需要将代码中的模型 ID 替换为 Gemini 3.8 Live 对应的标识符。对于 TTS 用户，则需要切换到 Gemini 3.8 Flash TTS。好消息是，迁移主要涉及模型 ID 的变更，而不是整个 API 架构的重写。

Flash 是 Gemini 模型家族中面向低延迟、高吞吐场景的轻量系列，与 Pro 系列相比以更小的模型规模和更快的首 token 时间为卖点，适合实时语音这类对响应速度敏感的任务。在 TTS 场景下，Flash 版本通常意味着更短的合成延迟和更低的单位成本，但音质细腻度或情感表现力可能与更大模型存在差异，迁移时需要重点试听评估。Live API 的正式版模型则通常意味着更稳定的会话管理语义、更明确的并发配额和计费规则。需要注意的是，预览模型到正式版的跨越往往伴随参数重命名、默认值变化甚至字段废弃，因此版本号跳跃（如从预览版直接到 3.8）并不只是营销数字，而是反映了 API 形态的实质演进。

会话配置与 TTS 请求的具体变化

迁移并非只是改一个字符串那么简单。公告指出，会话配置（session config）和 TTS 请求（TTS request）的格式会有所调整。这意味着开发者需要检查两处代码：

• Live API 的会话初始化参数：新模型可能对音频采样率、语音活动检测或上下文窗口的配置字段有新的要求或默认值。
• TTS 请求体：语音选择、输出格式或速率参数可能发生变化，需要对照新模型的文档进行适配。

建议在测试环境中先用新模型跑通完整流程，再逐步替换生产环境的配置，避免在 11 月 17 日截止前出现服务中断。

价格变化：迁移前需要算一笔账

公告提到会对比迁移前后的价格。预览模型通常有试用期定价或免费额度，而正式版模型（尤其是 3.8 系列）的计费标准可能不同。开发者需要关注两个维度：Live API 的按会话时长计费方式，以及 TTS 按字符或音频时长计费的方式是否调整。

如果新模型的单价高于旧预览版，提前评估调用量并优化请求频率就很有必要。反过来，如果 Flash 系列带来了成本下降，那这次迁移也是一次优化账单的机会。

按会话时长计费是 Live API 的典型模式：计费单位通常是连接维持的秒数或分钟数，而非 token 数，因为实时音频流难以按 token 精确计量。这意味着即使用户沉默，只要连接保持打开就可能产生费用，优化策略包括及时关闭空闲会话、设置服务端超时。TTS 的计费则常见按输入字符数或输出音频时长两种口径，部分服务还会对不同的音质档位（如标准音质与高保真音质）采用不同单价。迁移评估时应把旧预览版的免费额度或试用折扣剔除，用真实调用量乘以新单价做对比，并留意新模型是否引入了最低计费时长、并发上限等隐性成本项。

代码改动清单

综合来看，需要动手的地方集中在三处：

1. 模型 ID 替换：将 Live 和 TTS 的模型标识符更新为 3.8 版本。
2. 请求结构适配：根据新模型文档调整 session config 和 TTS 请求字段。
3. 回归测试：验证实时交互的延迟、语音合成的音质和格式是否符合预期。

这次退役提醒开发者：预览模型适合快速验证想法，但生产环境依赖预览版始终存在断供风险。提前规划迁移，比在截止日前仓促切换要稳妥得多。