核心结论
北京时间 9 月 22 日,Google 在 GitHub 发布 Python 官方 SDK python-genai v2.25.0。官方发布页标题明确标注为 2.25.0(2026-09-22),对比区间为 v2.24.0 至 v2.25.0。本次为小幅功能更新,核心变化是新增 Voices API 资源、Voice 增加 sample_audio 及公开语音元数据与语音配置等 6 项能力,另修复 1 项路径参数描述问题。以上版本、日期与对比区间由官方仓库发布页直接确认;影响判断为编辑基于发布说明的解释。
变化细节
官方发布说明将新增归为 Features,共 6 项:向 Voice 增加 sample_audio、新增 Voices API 资源、公开 SpeechMetadata、VoiceConfig.voice 与 SpeechAnnotation、支持字段值语法标注、更新发现文档并将语音接入 SDK。官方将其列为企业智能体平台与公开 GenAI SDK 范畴的语音与标注能力,未描述为新模型或性能优化。以上条目为官方宣布内容,未经独立测试验证。
官方本次在 Bug Fixes 中列出 1 项:清理企业智能体平台 OpenAPI 生成中的路径参数描述。官方本次未列出新增模型支持、价格配额、性能基准、许可证变更或破坏性接口声明。与 9 月 16 日的 v2.24.0 相比,本次不引入模型能力变化,仅做语音封装与生成器配套维护。编辑未将其扩大为功能发布或可用性承诺。
影响与适用范围
受影响对象为已使用或计划通过 google-genai 对接 Gemini API 的 Python 项目,特别是此前需调用语音合成、查询可用声音或处理语音标注的链路。更新后语音资源调用路径更完整,有助于减少自行封装与排查。仅使用其他语言 SDK 或 REST 直调的用户不受本次 Python 客户端更新直接影响。中国开发者可在官方仓库核对版本号与对比区间后评估升级,服务端模型与配额仍以账户实际开通为准。
限制与下一步
本次发布说明未提供基准性能、成功率或成本对比数据,不应理解为性能或成本承诺。语音能力的实际可用性仍受服务端、区域、配额与账户权限影响,SDK 封装更新不等同于对应服务端能力已对当前账户开放。建议先在测试环境回归语音调用与现有生成链路,再全量升级。若后续出现补充说明或修复版本,将以新的可核验事件另行处理。