Speakeasy
的使用方法、功能与可解决的业务课题

使用方法

1. 准备 OpenAPI 规范

   准备好自家 API 的 OpenAPI（Swagger）规范文件。Speakeasy 将此规范作为唯一可信来源（Single Source of Truth），并从中生成 SDK 及其他产物。

2. 安装 CLI 并运行快速启动命令

   安装 Speakeasy CLI（单一可执行文件），并运行 quickstart 命令。以交互方式指定要生成的语言及软件包信息。

3. 选择要生成的语言

   选择并生成所需语言的 SDK，支持 TypeScript、Python、Go、Java、C#、PHP、Ruby 等。Terraform Provider 和契约测试也可在此处生成。

4. 自定义配置

   通过 OpenAPI 扩展修改方法名或对操作进行分组，或在重新生成后保留手写代码，对生成内容进行精细调整。

5. 通过 CI/CD 自动发布

   与 GitHub Actions 等工具集成，以 OpenAPI 规范变更为触发条件自动重新生成 SDK，并自动完成版本号更新、变更日志生成以及发布至各包管理器（npm、PyPI、Maven Central 等）的全流程。

功能

• 多语言类型安全 SDK 生成

  从 OpenAPI 规范生成 TypeScript、Python、Go、Java、C#、PHP、Ruby 等语言的 SDK。生成的代码追求符合语言惯例（idiomatic）、类型安全、可投入生产的品质。

• MCP 服务器生成

  可生成 MCP（Model Context Protocol）服务器，使 API 能够被 AI 智能体调用。适用于将现有 API 对接 AI 集成的场景。

• Terraform Provider 生成

  从 OpenAPI 规范生成 Terraform Provider，实现以代码（IaC）方式管理 API。

• 契约测试生成

  生成用于验证 API 与规范一致性的契约测试，防止规范与实现之间产生偏差。

• 认证、重试与分页支持

  内置 OAuth 2.0、API Key、Bearer Token 等认证方式，支持指数退避自动重试、分页辅助、Webhook 签名验证等实用功能。

• CI/CD 与自动发布

  检测规范变更后自动重新生成 SDK，并自动完成版本号更新、变更日志生成及软件包发布。

• OpenAPI 工具链

  提供 OpenAPI 规范的 lint、预览和自定义工具集，助力提升规范本身的质量。

价格

以下价格信息截至 2026 年 6 月。以美元计价，折算人民币金额因汇率而浮动。计费单位为"每语言・每个 operation（OpenAPI 的 operationId）"，最新信息请参阅官方价格页面。

※ 生成代码的所有权归用户所有。operation 按规范中唯一 operationId 数量计算，被排除的端点不计入计费。

优缺点

优点

• 从一份 OpenAPI 规范即可同时生成多语言 SDK，大幅减少手工编写和维护的工作量
• MCP 服务器、Terraform、契约测试均可用同一工具生成
• 可通过 CI/CD 跟踪规范变更，实现从生成到发布的全流程自动化
• 生成代码所有权归用户，有效避免供应商锁定

缺点

• 操作界面和文档以英文为主
• 付费方案按语言和 operation 计费，规模较大时需进行成本规划
• 要生成高质量 SDK，需要具备整理 OpenAPI 规范的前置知识

用户评价

• 开发者评价称"可以从 OpenAPI 一次性生成多语言 SDK，SDK 维护负担大幅减轻"。
• 有用户表示"生成代码可读性高，重试和认证都已内置"、"能生成 Terraform Provider 非常方便"。
• 另有反馈指出"以英文为主"以及"按语言和 operation 计费，超出免费额度后费用不够透明"。

常见问题（FAQ）

Q. Speakeasy 可以免费使用吗？

可以。免费方案支持每语言最多 250 个 operation 的 SDK・MCP 生成及自动发布软件包。如需扩大规模或使用额外功能，则需要升级至 Business 及以上付费方案。

Q. 支持生成哪些语言的 SDK？

支持 TypeScript、Python、Go、Java、C#、PHP、Ruby 等主流语言，此外还可生成 Terraform Provider、契约测试和 MCP 服务器。

Q. 生成代码的所有权归谁？

生成代码的所有权归用户所有。

Q. 是否支持中文？

操作界面和文档以英文为主，不提供中文 UI。生成的 SDK 本身遵循各语言规范。

Speakeasy 与其他 SDK 生成及开发辅助工具的对比

如需更详细的对比，请参阅相关服务的各页面。