---
title: "安装 AI 生成扩展"
description: "在编辑器中设置 Tiptap AI 生成，包括配置 OpenAI 密钥和 JWT 认证。详情请查阅文档！"
canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/generation/install"
---

# 安装 AI 生成扩展

在编辑器中设置 Tiptap AI 生成，包括配置 OpenAI 密钥和 JWT 认证。详情请查阅文档！

- **1. 激活试用或订阅**

  在您的账户中开始[免费试用](https://cloud.tiptap.dev/v2?trial=true)或[订阅入门计划](https://cloud.tiptap.dev/v2/billing)。
- **2. 集成 AI 提供商**

  在您的[AI 设置](https://cloud.tiptap.dev/v2/cloud/ai)中配置 OpenAI，或查看[自定义 LLM 指南](https://tiptap.zhcndoc.com/content-ai/custom-llms.md)。
- **3. 从私有注册表安装**

  要安装前端扩展，请按照[安装指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md)登录 Tiptap 私有 npm 注册表。

本安装指南基于使用 [Tiptap 内容 AI 后端服务](https://cloud.tiptap.dev/v2/cloud/ai)，如果您想配置自己的自定义 LLM，请改为参考[此指南](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/custom-llms.md)。

## 启动你的 Content AI 应用

1. **激活套餐：** 先[免费试用或选择订阅](https://cloud.tiptap.dev/v2/billing)。
2. **配置你的 AI 应用。** 将你的 OpenAI API 密钥添加到你的 [Content AI 应用](https://cloud.tiptap.dev/v2/cloud/ai) 中。
3. **设置身份验证：** 使用 `aud: "AI"` 和 `AI:Generation` 权限签名一个令牌，然后将其传递给扩展。有关如何签署令牌，请参见[身份验证](https://tiptap.zhcndoc.com/authentication.md)。

## 访问私有注册表

AI 生成扩展发布在 Tiptap 的私有 npm 注册表中。请按照[私有注册表指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md)集成此扩展。如果您已完成 Tiptap 账户认证，可直接跳转到[#安装](#安装)。

## 安装

```bash
npm install @tiptap-pro/extension-ai
```

集成到您的编辑器实例中的方法与其他 Tiptap 扩展相同。下面是示例代码：

```js
import { Editor } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'
import Ai from '@tiptap-pro/extension-ai'

const editor = new Editor({
  extensions: [
    StarterKit,
    Ai.configure({
      // 这需要是您的签名令牌，且绝不能是 OpenAI API 密钥！
      token: 'TOKEN_HERE',
      autocompletion: true,
      // … 其他选项（详见下文）
    }),
    // … 其他扩展
  ],
})
```

此时，您即可在 Tiptap 编辑器中使用 OpenAI。可查看[配置选项](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/configure.md)以定制您的使用体验。

先前的 App ID 和密钥（HS256）流程仍然可用，并记录在[旧版身份验证](https://tiptap.zhcndoc.com/authentication/legacy.md)中。

## 隐私与数据处理

了解 Tiptap 如何处理 AI 请求及管理您的内容数据，请参阅我们的[隐私文档](https://tiptap.zhcndoc.com/content-ai/resources/privacy.md)。文档涵盖数据保留、安全措施及使用内容 AI 功能的合规信息。