Google 与 Speakeasy 以 AGPLv3 开源 OpenAPI 客户端生成套件

9 月 17 日，Google 通过 Google AI Studio 的（@GoogleAIStudio）和发布题为《Why client SDK generation belongs in the open》的公告：Google 与 Speakeasy 合作，把 Speakeasy 的 OpenAPI 客户端代码生成套件开源，采用 AGPLv3 许可。

这次开源分三块：覆盖 Python、TypeScript、Go、Java、C#、PHP、Ruby 七种语言的 SDK 生成器，agent（智能体）原生 CLI（命令行）生成器，以及文档 MCP（Model Context Protocol）服务器生成器。Google 称，这套工具已经支撑其面向 Interactions、Agents 与 Webhooks API 的新 Google GenAI SDK。Speakeasy 也在 9 月 17 日发布确认合作，生成器代码已托管在 GitHub 仓库。

生成器能力与仓库支持范围

按公告描述，每种语言生成的客户端库都包含静态类型、SSE（server-sent events）流式、重试与分页。CLI 生成器把 API 编译成独立二进制，AI coding agent 可以直接在终端会话里调用 API，不必再写用完即弃的 HTTP 脚本。文档 MCP 服务器生成器把 OpenAPI spec 与 markdown 文档转成 MCP 服务器，让 Antigravity 这类 coding agent 查询实时、经过验证的 schema，不必再猜测过时的方法。

仓库 README 列出的支持范围是 12 个主要目标，除七种语言对应的 SDK 目标外，还包括 MCP TypeScript 与 Unity 两个 SDK 与工具目标，以及 CLI 应用、Postman collection、Terraform provider 三类其他产出。这个生成器用 Go 写成，支持 OpenAPI 3.0 与 3.1，并能处理 3.2 的部分构造。

公告附带的 Python 示例展示了生成后的 SDK 用法：用 client.interactions.create 以 gemini-3.8-flash 模型发起调用，再读取 interaction.output_text。

供应商在 5 月被收购关停

Google 在公告里解释了转向开源的原因。公告称，从快速演进的 OpenAPI spec 为多种语言生成干净、地道的 SDK 是工程难题；多年来，包括 Google 在内的前沿 AI 生态依赖专门工具，让客户端库能处理复杂的流式协议、严格的错误层级和丰富的类型联合，同时不显得「机器生成」。2026 年 5 月，就在 Google 为 I/O 大会和 Interactions API 的正式可用（GA）做准备时，其使用的 SDK 生成服务商被收购，并突然宣布关闭。Google 称，专有闭源生成器带来「不可接受的平台风险」：如果行业用 OpenAPI 定义接口，把接口编译成客户端库、CLI 和 agent 工具的工具链就应当是开放基础设施。

这家服务商是 Stainless：据 2026 年 5 月 18 日报道，Anthropic 当天宣布收购这家 SDK 生成器初创公司，并将关停其全部托管产品，包括 SDK 生成器；交易条款未披露。Stainless 的软件被 OpenAI、Google 等公司使用。Anthropic 发言人当时表示，Stainless 客户仍然拥有已经生成的 SDK，并有权自由修改和扩展。

Speakeasy 的博文补充了 Google 一方的细节：Google 团队最初自己维护这套流水线，2025 年底转向供应商方案；供应商关停后，Google 选择推迟 Interactions API 的 GA，以避免仓促发布有问题的 SDK。Speakeasy 还称，API 产物是关键依赖，需要连续性；经历了一次关键依赖突然消失之后，Google 希望整个生态不会再经历同样的突然中断。

Google 的 Logan Kilpatrick 在公告帖下称：「很高兴我们与 Speakeasy 在这件事上合作，此前的 SDK 供应商风险对整个生态来说非常真实。」

迁移工程：对齐类型、保留错误层级与流式行为

Google 称，与 Speakeasy 的目标是把客户端库「就地」迁移，并以让生成器套件开源为核心承诺。迁移的工程量集中在三件事：跨所有目标语言对齐类型定义，保留原有严格的错误层级与流式行为，把生成器直接接进 Google 内部的 monorepo（单一代码仓库）与构建系统。

公告还说明了工具选型的取舍：团队在 Google DeepMind，虽然各类开发流程都在使用 AI，但栈的每一层要选对工具；把正式 API 规格转换成多语言 SDK 需要确定性与严格类型安全，因此这套方案以快速、确定性的生成器为核心，SDK 中的自定义部分交给 Antigravity 的 AI agent 加速。Google 称，此前手工维护生成器需要多名工程师；现在这套配置的维护只需要约 1 名工程师。

给 agent 的文档接口：Gemini Docs MCP server 与 Antigravity

Speakeasy 称，这场合作从 SDK 迁移扩大成更广的协作：在 SDK 层之后，问题变成了 agent 需要 API 提供什么，焦点也从开发者体验（DX）延伸到 agent 体验（AX）。

Speakeasy 介绍的第一个新成果是 Gemini Docs MCP server：它让 AI coding agent 直接读取 Google 维护的、以 markdown 为主的文档，写 Gemini API 代码时读到的是当前版本，而不是训练数据里的旧版本；它还会引导 agent 使用官方 SDK，避免臆造集成。这个服务器已预先打包进 Antigravity。

Speakeasy 同时说明了这次开源与其商业产品的关系：生成器开源后，任何公司都能把自己的数据做成 agent 可访问的接口；Speakeasy 则继续做 AI 控制平面（AI control plane），处理 agent 连接真实系统时的身份、策略与可观测性。

许可边界：生成器与生成物的分层规则

Google 公告称，生成器以 AGPLv3 授权，开发者可以在开发或 CI 流水线中运行它，同时对生成的代码和 SDK 保留完整所有权，可按自选许可（例如 MIT 或 Apache 2.0）发布；只有修改生成器编译器本身时，AGPL 才要求这些改进对社区保持开源。Speakeasy 博文的说法是，用这些工具生成的代码「永久属于你」。

仓库里的把边界写得更细：生成器源码为 AGPL-3.0-only，Speakeasy 也可以按书面协议单独授权；在有效的 Speakeasy 付费计划、试用或其他商业授权下生成的产物，其中的 Speakeasy 代码不产生 AGPL 义务，客户可按自选条款使用、修改、分发和再许可，该权利对该产物永久有效，不随授权到期或终止失效。商业授权结束后，用户可以明确选择 AGPL-3.0-only 继续生成新产物，此时其中的 Speakeasy 代码适用 AGPL-3.0-only；要生成不带这些义务的新产物，需要当前的商业授权。第三方许可继续适用。

仓库 README 还写明：持有商业令牌时，生成的 SDK 归使用者所有，可按自选条款使用，包括输出中复制进来的 Speakeasy 代码，且令牌过期后权利延续。贡献者需要签署贡献者许可协议（CLA），允许 Speakeasy 同时以 AGPL-3.0 和商业许可提供其贡献。

对想把生成器接进自家流水线的团队来说，运行前必须先完成一次许可选择：AGPL-3.0-only 或商业授权令牌；不做选择，生成器不会运行。

Google 称，其客户端管线目前覆盖 6 个生成目标，其中 3 个 SDK 已发布，其余会很快推出。