Gemini 3.8 Live 429 报错怎么解

Gemini 3.8 Live 的 429 不是一个错误，而是三种：分钟级限流、每日配额用尽、花费上限触发。先看响应体里的 code 属于哪一种再动手，否则改配置、换 Key 都可能白费。

先对号入座：三种 429 症状不同

官方 API 错误参考写得很清楚，Live API 返回的 429 至少对应三种 code：

处理方向完全不同：第一种退避重试可恢复，第二种等重置，第三种先修客户端逻辑。

原因一：分钟级限流被打满

Gemini API 的限额按三个维度同时评估：每分钟请求数（RPM）、每分钟输入 Token 数（TPM）、每天请求数（RPD）。任意一项超限都会触发限流，即使其他两项还有余量。

Live API 特别容易撞上 TPM：音频按 16kHz 连续输入、按 24kHz 连续输出，单位时间消耗远高于普通文本请求，同一分钟开几个音频会话就会把 TPM 吃掉。

两个容易忽略的细节：

1. 限额按项目计，不按 API Key 计。换 Key 不会扩容，反而让人误判是 Key 有问题。
2. 预览版和实验版模型限额比正式版更紧。gemini-3.8-live-extended-thinking 这类带推理能力的变体消耗更高，更容易先撞墙。

原因二：每日配额用尽

如果 code 是 quota_exceeded，说明打满的是每日请求数配额，重试再快也没用。

RPD 配额在太平洋时间午夜重置，换算到北京时间大约是下午三点，所以白天遇到的 quota_exceeded 通常要等到这个时间之后才恢复。这类配额同样按项目计算，只有等重置、降用量或提额三条路。

原因三：花费上限触发

除请求维度外，Gemini API 还有一层按花费计算的限额，用来防止意外账单。它的返回码是 RESOURCE_EXHAUSTED，评估窗口是滚动的 10 分钟。

官方的建议是隔一小段时间重试，并降低昂贵请求频率，例如缩小上下文、缩短输出。

原因四：会话寿命被误当成限流

这条最容易被误判。官方给出的会话限制是：

1. 不做上下文压缩时，纯音频会话最长 15 分钟，音视频会话最长 2 分钟。
2. 连接寿命约 10 分钟，断开前服务端会先发一条 GoAway 消息。
3. 超出限制会直接终止会话和连接。

把「连接被断」当成 429 并立刻重连，会在短时间内造出大量新会话，反而真的把分钟级限流打满。正确做法是打开上下文窗口压缩让会话不设上限，并启用会话续接（session resumption），用服务端下发的 resumption token 接着聊，官方说明该 token 在会话终止后 2 小时内有效，细节见会话管理文档。

客户端直连还要留意临时令牌的时间窗：官方默认给 1 分钟用它开新会话、30 分钟用它发消息，超时需要重新申请，见临时令牌文档。

解法一：退避重试要写对

官方推荐的策略是指数退避加重试上限，只在瞬时错误上重试：

1. 第一次重试等约 1 秒，之后按 2 秒、4 秒、8 秒递增。
2. 加入随机抖动，避免所有客户端同时重试。
3. 只对 429、408 和 5xx 重试，400、403 这类客户端错误重试没有意义。
4. 设置最大重试次数，防止无限循环。

官方 Python SDK 已内置这套逻辑：默认对瞬时错误自动重试最多 4 次，初始延迟约 1 秒，最大 60 秒。用了官方 SDK 仍被 429 打断，说明问题在配额而不是重试策略。限流与退避的通用原理见429 报错是什么？速率限制与退避重试。

解法二：把消耗降下来

不想升级层级，最直接的办法是降消耗：

1. 缩小上下文窗口，长会话用压缩而不是无限堆历史。
2. 缩短单次输出，语音场景限制回复长度最有效。
3. 串行化会话，避免同一项目并发开多个 Live 连接。
4. 非实时任务挪去别的接口，实时语音接口不该跑批量任务。

解法三：提额与选对模型

确认是正常业务量撞上限，就按官方流程申请提额，官方口径是不保证批但会尽力审。

还有一个立刻见效的办法是换模型。gemini-3.8-live 是官方标注的默认 Live 模型，定位低延迟语音场景；带扩展思考的版本能力更强但消耗更高。只做基础语音交互时用默认版，限额压力会小很多。另外优先级推理虽有独立配额，但默认额度只有标准额度的 0.3 倍，不适合用来绕限流。

官方口径与预防

官方定位：限额是为公平使用和系统稳定，实际容量不保证。想少踩坑做三件事：

1. 定期在 Google AI Studio 查看项目的活跃限额，别凭感觉估。
2. 在监控里按 code 分类统计 429，区分「该退避」和「该提额」。
3. 把会话压缩和会话续接写成默认配置，而不是出问题后再补。

想先搞清楚这套语音模型的能力边界和订阅门槛，可以看Gemini 3.8 Live 怎么用和Gemini 3.8 Live 免费用。