Google 于 2026-09-30 发布 google-genai v2.26.0(PyPI 约 2026-09-30T22:53Z;相对 v2.25.0...v2.26.0 ahead_by 18)。模型枚举新增 gemini-3.8-flash-tts(Voice Design / 双说话人剧本控制)与 gemini-3.8-flash-lite-tts(高速配音与语音 Agent,定位替换 gemini-3.1-flash-tts-preview);首发独立 Environments 模块与 from_environment;GenerateContent / LiveClientSetup 支持 labels;调参任务可导出 gcs_metrics_uri。

核心要点速览 (Key Takeaways)

  • ✓发版:v2.26.0(2026-09-30T22:17:07Z);PyPI google-genai==2.26.0;compare ahead_by 18
  • ✓TTS:gemini-3.8-flash-tts(旗舰 Voice Design / 双说话人);gemini-3.8-flash-lite-tts(高速/低成本,替代 gemini-3.1-flash-tts-preview)
  • ✓Environments:独立模块 + from_environment;类型面暴露 environments / triggers / webhooks / agents 子模块
  • ✓可观测:Gemini API GenerateContent 与 LiveClientSetup 支持 labels;tuning 增加 gcs_metrics_uri
  • ✓开箱:pip install -U 'google-genai==2.26.0';文档 googleapis.github.io/python-genai;仓库 googleapis/python-genai
🧭

阅读完核心要点?进一步了解模型实力与实际开销

7 大权威镜像天梯跑分与 29+ 款主流编程套餐横向比价测算

🔬

深度技术解析与实战评估

核心背景与行业痛点

语音 Agent、本地化配音与 Voice Design 需要稳定的 TTS 模型 ID 与 SDK 枚举同步;旧预览 gemini-3.1-flash-tts-preview 迫使产线钉死 preview 字符串。另一方面,Gemini Enterprise / Agent Platform 的 Environments、Triggers、Webhooks 能力若仍散落在生成代码深处,Python 应用很难做「从环境对象拉配置」的一等公民接入。计费与多租户还需要 GenerateContent / Live 会话带 labels。国内读者请以 v2.26.0 release 与 官方文档 为准。

架构亮点与底层机制

[v2.26.0](https://github.com/googleapis/python-genai/releases/tag/v2.26.0) 在 interactions model 枚举写入 gemini-3.8-flash-tts(旗舰 TTS:Voice Design、双说话人剧本、vocal bursts)与 gemini-3.8-flash-lite-tts(高速/成本向,标注为 gemini-3.1-flash-tts-preview 的直接替换)。新增 Environments 专用模块与 from_environment(commit 7672ff6),并把 environments / triggers / webhooks / agents 域类型暴露到独立子模块。Gemini API GenerateContent 与 LiveClientSetup 支持 labels;tuning 任务增加 gcs_metrics_uri 导出指标。另含 aiohttp 会话回收、Vertex interactions 默认 timeout、CLI --usage 短选项等修复。相对 v2.25.0 ahead_by 18。

权威 Benchmark 与实测跑分对比

SDK 发行说明未给出 TTS MOS、RTF 或 SWE-bench 分数——这是客户端能力同步,不是新基础模型评测包。可核对:GitHub 2026-09-30T22:17:07Z,PyPI wheel 2026-09-30T22:53:21Z,ahead_by 18。语音质量与定价以 Google 模型卡 / Cloud 控制台为准;请在自有语料上对比 lite vs flagship 的延迟与费用。

开发者实战落地与开箱指南

  1. 升级:pip install -U 'google-genai==2.26.0'(或 uv pip install google-genai==2.26.0)。
  2. TTS:将预览 ID 迁到 gemini-3.8-flash-lite-tts;需要 Voice Design / 双说话人用 gemini-3.8-flash-tts。
  3. Environments:按文档使用 client.environments / from_environment;为 GenerateContent 与 Live 设置 labels 便于成本分摊。
  4. 文档:python-genai docs、GitHub、PyPI。