speakeasy-api/speakeasy

解决的问题

Speakeasy 为 API 开发者提供现代化的工具链，可自动创建高质量、类型安全的客户端 SDK、Terraform 提供者和契约测试。它消除了在 API 演进过程中，跨多种编程语言手动编写和维护这些资产的繁琐工作。

工作原理

Speakeasy 以 OpenAPI 3.X 规范作为唯一可信来源。它提供了一套工具，用于对这些规范进行 lint、清理和编辑（通过 Overlays），然后为 10 多种语言生成精炼、符合语言习惯的 SDK 代码、Terraform 提供者以及由 Arazzo 驱动的契约测试。

适用人群

需要将 API 以多种语言（例如 TypeScript、Python、Go、Java、C#、PHP、Ruby、Unity）分发给用户，并确保 API 合同被严格验证的 API 提供者和开发者。

主要亮点

• 多语言 SDK：为 10 多种语言生成符合语言习惯、类型安全的代码。
• Terraform 提供者：基于类型安全的 Go SDK 自动生成完整的 Terraform 提供者。
• 契约测试：通过预构建的模拟服务器生成契约测试。
• OpenAPI 工具链：包含用于 lint、diff 和编辑 OpenAPI 规范的工具链。
• AI 代理集成：提供「代理技能」，使 AI 编码代理（如 Claude Code、Cursor 和 GitHub Copilot）能够管理 SDK 项目并验证规范。