> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-mintlify-add-hello-world-quickstart-48843.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Speakeasy

> 在 API交互测试台中自动生成你的 SDK 使用代码片段

由 Speakeasy SDK 自动生成的代码片段可直接集成到 Mintlify 的 API 参考文档中。SDK 使用代码片段会显示在由 Mintlify 驱动的文档站点的[交互式 API交互测试台](/zh/api-playground/overview)中。

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/9lElgRHqAJ6W2ryc/images/speakeasy/mintlify-with-speakeasy-openapi.png?fit=max&auto=format&n=9lElgRHqAJ6W2ryc&q=85&s=0b658d00b6bf7ef39f2c4ff716dad716" alt="带有 Speakeasy 代码片段的 Mintlify API交互测试台。" width="2560" height="1440" data-path="images/speakeasy/mintlify-with-speakeasy-openapi.png" />
</Frame>

<div id="prerequisites">
  ## 前提条件
</div>

要将 Mintlify 与 Speakeasy 集成，你需要：

* 一个 [Mintlify 文档仓库](/zh/quickstart#creating-the-repository)。
* 一个由 Speakeasy 生成且已配置[自动化代码示例 URL](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls)的 SDK。

<div id="setting-up-the-integration">
  ## 设置集成
</div>

要将 Speakeasy 与 Mintlify 集成，您需要从注册表获取该 API 的合并规范公开 URL，并更新您的 `docs.json` 文档配置文件。

<div id="get-the-apis-combined-spec-public-url-from-the-registry">
  ### 从注册表获取该 API 的合并规范公开 URL
</div>

前往 [Speakeasy 控制台](https://app.speakeasy.com)，打开 **API Registry** 选项卡。打开该 API 的 `*-with-code-samples` 条目。

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/9lElgRHqAJ6W2ryc/images/speakeasy/openapi-registry-and-combined-spec.png?fit=max&auto=format&n=9lElgRHqAJ6W2ryc&q=85&s=6b8ef0dd8336bfe90c397dd3fc89ac88" alt="Speakeasy API Registry 页面截图。API Registry 选项卡用红色方框和数字 1 标注，API 的条目用红色方框和数字 2 标注。" width="2560" height="1440" data-path="images/speakeasy/openapi-registry-and-combined-spec.png" />
</Frame>

<Note>
  如果该条目未标注为 **Combined Spec**，请确保该 API 已配置 [自动代码示例 URL](https://www.speakeasy.com/docs/code-samples/automated-code-sample-urls)。
</Note>

在该注册表条目的页面中，复制提供的公开 URL。

<Frame>
  <img src="https://mintcdn.com/mintlify-mintlify-add-hello-world-quickstart-48843/9lElgRHqAJ6W2ryc/images/speakeasy/copy-combined-spec-url.png?fit=max&auto=format&n=9lElgRHqAJ6W2ryc&q=85&s=d3e37b95f08f742829ab7886b7ba383a" alt="显示合并规范注册表条目的截图，复制 URL 功能用红色方框标注。" width="2560" height="1440" data-path="images/speakeasy/copy-combined-spec-url.png" />
</Frame>

<div id="update-your-docsjson-configuration-file">
  ### 更新您的 `docs.json` 文档配置文件
</div>

将合并规范 URL 添加到 `docs.json` 文件中的 **Anchors** 或 **Tabs** 部分。

在 `docs.json` 文件中按如下方式更新 `anchor` 字段，将合并规范 URL 添加到某个 anchor：

```json 文档配置文件
{
  "anchors": [
    {
      "name": "API 参考",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL",
      "url": "api-reference",
      "icon": "square-terminal"
    }
  ]
}
```

在 `docs.json` 文件中按如下方式更新 `tab` 字段，将合并后的规范 URL 添加到一个选项卡：

```json docs.json
{
  "tabs": [
    {
      "name": "API 参考文档",
      "url": "api-reference",
      // !mark
      "openapi": "SPEAKEASY_COMBINED_SPEC_URL"
    }
  ]
}
```

由 Speakeasy 生成的代码片段现已可在你的 API 文档中查看，并可在 API交互测试台中直接试用。