Google 与 Speakeasy 开源 OpenAPI SDK 生成套件

2026年9月17日

在过去几个月里，我们与 Speakeasy 紧密合作，为我们的 Interactions、Agents 和 Webhooks API 发布了全新的 Google GenAI SDK。今天，我们很高兴地宣布，我们已与 Speakeasy 达成合作，将其 OpenAPI 代码生成套件开源。

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Analyze this commit log and find regressions.",
)

print(interaction.output_text)

Python

已复制

为什么客户端生成需要开放工具

从快速演进的 OpenAPI 规范中生成干净、地道的多语言 SDK 是一项工程挑战。多年来，包括 Google 在内的前沿 AI 生态系统一直依赖专门的工具来生成客户端库，以处理复杂的流式协议、严格的错误层级和丰富的类型联合，同时避免机器生成的痕迹。

2026 年 5 月，正当我们为 Google I/O 和 Interactions API 的正式发布做准备时，我们当时使用的 SDK 生成服务提供商被收购，并突然宣布关停。

这一突如其来的变故凸显出，专有的闭源生成器会带来不可接受的平台风险。如果整个行业依赖 OpenAPI 来定义接口，那么将这些接口编译为客户端库、CLI 和智能体工具的工具链就应当成为开放基础设施。

评估前进之路

当我们在紧迫的时间表下重构 SDK 流水线时，我们的首要任务是尽量减少对开发者的干扰，避免破坏性变更。

我们与 Speakeasy 合作，就地迁移我们的客户端库，核心承诺是让生成器套件开源。此次迁移需要精心的工程工作：对齐所有目标语言的类型定义，保留严格的错误层级和流式行为，并将生成器直接集成到我们的内部 monorepo 和构建系统中。

在 Google DeepMind，虽然我们在整个开发工作流中都在使用 AI，但我们相信要为技术栈的每一层选择正确的工具。将正式的 API 规范转换为多语言 SDK 需要确定性和严格的类型安全。借助 Speakeasy，我们将快速、确定性的生成器作为核心，同时用 Antigravity AI 智能体加速 SDK 的定制部分。

维护此前手工打造的生成器过去需要多名工程师。如今，这套方案以大约一名工程师的维护成本，支撑着我们覆盖六个目标的客户端流水线（三个已发布的 SDK，更多即将推出）。

今天开源的内容

为了帮助更广泛的开发者生态系统获得高质量、维护良好的 SDK 生成工具，同时避免类似的中断风险，Speakeasy 正在开源其完整的 OpenAPI 客户端套件，采用 AGPLv3 许可证。

多语言 SDK 生成器：为 7 种语言（Python、TypeScript、Go、Java、C#、PHP、Ruby）生成客户端库。每个库都包含静态类型、服务器发送事件（SSE）流式传输、重试和分页。
智能体原生 CLI 生成器：编译独立的 CLI 二进制文件。AI 编码智能体可以直接在终端会话中运行你的 API，而无需编写一次性的 HTTP 脚本。
文档 MCP 服务器生成器：将你的 OpenAPI 规范和 markdown 文档转换为 Model Context Protocol (MCP) 服务器。像 Antigravity 这样的编码代理可以查询实时、经过验证的 schema，而不是猜测过时的方法。

该生成器采用 AGPLv3 许可。这允许你在开发或 CI 流水线中运行它，同时让你生成的代码/SDK 完全归你所有，并可采用你选择的许可证（如 MIT 或 Apache 2.0）。如果你修改了生成器编译器本身，AGPL 保证这些改进对社区保持开源。

试一试

你现在就可以使用我们更新后的 SDK 来探索新的 Gemini Interactions API。如果你想生成自己的客户端库、CLI 或 MCP 服务器，可以在 GitHub 上找到 Speakeasy 生成器，并针对你的 OpenAPI 规范运行它。

感谢阅读！继续构建吧。