--- title: "基础 AI 生成编辑器命令" description: "将 AI 集成到你的 Tiptap 编辑器中，以访问用于文本处理和图像生成的预配置命令。" canonical_url: "https://tiptap.zhcndoc.com/ai/basic/text-generation/built-in-commands" --- # 基础 AI 生成编辑器命令 将 AI 集成到你的 Tiptap 编辑器中，以访问用于文本处理和图像生成的预配置命令。 - **1. 激活试用或订阅** 开始您的[免费试用](https://cloud.tiptap.dev/v2?trial=true)或在您的账户中[订阅 Start 计划](https://cloud.tiptap.dev/v2/billing)。 - **2. 集成 AI 提供商** 在您的[AI 设置](https://cloud.tiptap.dev/v2/cloud/ai)中配置 OpenAI，或查看 [自定义 LLM 指南](https://tiptap.zhcndoc.com/ai/basic/custom-llms.md)。 - **3. 从私有注册表安装** 要安装前端扩展，请按照[设置指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md)进行身份验证，连接至 Tiptap 的私有 npm 注册表。 Tiptap Editor 的基础 AI 生成扩展包含一组预配置命令，您可以将其集成到富文本编辑器中。这些命令可让您调整文本语气、补全文本、生成图片等，从而增强编辑器的功能。 要了解这些命令的使用方式，请查看 [概览](https://tiptap.zhcndoc.com/ai/basic/overview.md) 页面上的示例。 | 命令 | 描述 | | ---------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | [`aiAdjustTone(tone: Tone, options: TextOptions)`](#aiadjusttone) | 将所选文本的语气调整为指定的 [TONE](#aitone)。 | | [`aiBloggify(options: TextOptions)`](#most-text-commands) | 将文本重写为博客格式 | | [`aiComplete(options: TextOptions)`](#most-text-commands) | 补全所选文本 | | [`aiDeEmojify(options: TextOptions)`](#most-text-commands) | 移除所选文本中的表情符号 | | [`aiEmojify(options: TextOptions)`](#most-text-commands) | 为您的文本添加表情符号 ✨ | | [`aiExtend(options: TextOptions)`](#most-text-commands) | 扩展您的文本 | | [`aiFixSpellingAndGrammar(options: TextOptions)`](#most-text-commands) | 修正拼写和语法 | | [`aiKeypoints(options: TextOptions)`](#most-text-commands) | 将您的文本总结为要点列表 | | [`aiRephrase(options: TextOptions)`](#most-text-commands) | 改写所选文本 | | [`aiRestructure(options: TextOptions)`](#most-text-commands) | 将所选文本重构为使用富文本格式 | | [`aiShorten(options: TextOptions)`](#most-text-commands) | 缩短所选文本 | | [`aiSimplify(options: TextOptions)`](#most-text-commands) | 用更简洁的词语改写您的文本 | | [`aiSummarize(options: TextOptions)`](#most-text-commands) | 总结您的文本 | | [`aiTextPrompt(options: TextOptions)`](#most-text-commands) | 运行您的自定义提示词 | | [`aiTldr(options: TextOptions)`](#most-text-commands) | 创建一个“Too Long; Didn't Read”版本的文本 | | [`aiTranslate(language: Language, options: TextOptions)`](#aitranslate) | 将所选文本翻译为指定语言 | | **实用工具** | | | [`aiAccept(options: AcceptOptions)`](https://tiptap.zhcndoc.com/ai/basic/text-generation/manage-responses.md#aiaccept) | [接受生成的响应](https://tiptap.zhcndoc.com/ai/basic/text-generation/manage-responses.md)，并将其插入编辑器中 | | [`aiReject(options: RejectOptions)`](https://tiptap.zhcndoc.com/ai/basic/text-generation/manage-responses.md#aireject) | [拒绝生成的响应](https://tiptap.zhcndoc.com/ai/basic/text-generation/manage-responses.md)，重置 ai.storage 状态 | | [`aiRegenerate(options: RegenerateOptions)`](https://tiptap.zhcndoc.com/ai/basic/text-generation/manage-responses.md#airegenerate) | 使用相同参数[重新生成响应](https://tiptap.zhcndoc.com/ai/basic/text-generation/manage-responses.md) | ### 大多数文本命令 大多数文本命令接受相同的选项，使用方法类似。以下示例展示了如何使用 `aiBloggify` 命令： ```js editor.chain().focus().aiBloggify(options: TextOptions) ``` ### aiAdjustTone ```js // 语气: 'default' | 'academic' | 'business' | 'casual' | 'childfriendly' | 'confident' | 'conversational' | 'creative' | 'emotional' | 'excited' | 'formal' | 'friendly' | 'funny' | 'humorous' | 'informative' | 'inspirational' | 'memeify' | 'narrative' | 'objective' | 'persuasive' | 'poetic' | string editor.chain().focus().aiAdjustTone(tone: Tone, options: TextOptions).run() ``` ### aiTranslate 将选中的文本内容翻译为指定的输出语言。 接受两个字母 ISO 639-1 语言代码。 ```js // 语言: 'en' | 'de' | 'nl' | ... editor.chain().focus().aiTranslate(language: Language, options: TextOptions).run() ``` ## 文本命令选项 对于支持 `TextOptions` 的每个命令，您可以指定以下选项： | Setting | Type | Default | Definition | | ---------------- | ---------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------- | | `modelName` | see [支持的文本模型](#支持的文本模型) | `gpt-5-mini` (`gpt-4.1` if `streaming: true`) | 在 OpenAI 中使用的模型 | | `format` | `'rich-text' \| 'plain-text'` | `plain-text` | 决定模型应如何响应的 [格式](https://tiptap.zhcndoc.com/ai/basic/text-generation/format.md) | | `stream` | `boolean` | `false` | 命令是否应将字符流式输出到编辑器？这类似于 ChatGPT 中的 **打字机** 效果。**这需要最新的扩展版本！** | | `insertAt` | `undefined \| number \| {from: number; to: number}` | `undefined` | 将响应插入到编辑器中的位置；如果为 `undefined`，响应将插入到当前选区。如果是数字，响应将插入到该位置。如果是对象，则会替换该范围。 | | `language` | `string` (e.g. `en`, `de`) | `null` | 虽然我们会尽力提示 OpenAI 以输入语言生成响应，但有时最好由您自己定义。 | | `tone` | `string` | `null` | 响应应转换为的 [语气](#ai-adjust-tone) | | `textLength` | `number` | `undefined` | AI 应响应的 `textLengthUnit` 数量（例如，“3 段”中的 `3`） | | `textLengthUnit` | `'paragraphs' \| 'words' \| 'characters'` | `undefined` | AI 应响应的 `textLength` 单位（例如，“3 段”中的 `paragraphs`） | | `collapseToEnd` | `boolean` | `true` | 操作完成后光标是否应设置到末尾，或者是否应选中插入内容。 | | `context` | `Array<{ type: 'text', text: string} \| { type: 'url', url: string }>` | `[]` | 提供给模型用于生成响应的 [上下文](https://tiptap.zhcndoc.com/ai/basic/text-generation/provide-context.md)。 | | `text` | `string` | `undefined` | 供模型响应的可选消息 | | `insert` | `boolean` | `true` | 允许禁用直接将内容插入编辑器 | | `append` | `boolean` | `true` | 如果为 `true`，响应将追加到当前选区末尾。如果为 `false`，响应将替换当前选区。 | | `regenerate` | `boolean` | `false` | 命令是否重新生成之前生成的响应。如果设置为 true，`initialContent` 属性将不会更新。 | *遗憾的是，**语气**与**语言**的组合有时会导致生成的响应不符合预期语言。* ### 支持的文本模型 目前支持如下 OpenAI 聊天模型： - `gpt-5` - `gpt-5-2025-08-07` - `gpt-5-mini` - `gpt-5-mini-2025-08-07` - `gpt-5-nano` - `gpt-5-nano-2025-08-07` - `gpt-5-chat` - `gpt-5-chat-2025-08-07` - `gpt-5.4-mini` - `gpt-5.4-nano` - `gpt-4.1` - `gpt-4.1-2025-04-14` - `gpt-4.1-mini` - `gpt-4.1-mini-2025-04-14` - `gpt-4.1-nano` - `gpt-4.1-nano-2025-04-14` - `chatgpt-4o-latest` - `gpt-4o-mini` - `gpt-4o-mini-2024-07-18` - `gpt-4o` - `gpt-4o-2024-11-20` - `gpt-4o-2024-08-06` - `gpt-4o-2024-05-13` - `gpt-4-turbo` - `gpt-4-turbo-2024-04-09` - `gpt-4` - `gpt-4-0613` - `gpt-3.5-turbo-0125` - `gpt-3.5-turbo` - `gpt-3.5-turbo-1106` - `gpt-3.5-turbo-16k` ## 选择合适的模型 在配置 Tiptap AI 扩展时，请根据您的应用需求考虑： - **对于成本效益型操作：** 如果主要关注预算，且任务不需要最先进的能力，则选择 GPT-5 mini。 - **对于高级需求：** 如果您的应用需要最高水平的语言理解或图像生成质量，且预算限制较少，则选择 GPT-5。 Tiptap AI 扩展的灵活配置使您能够根据具体需求和预算调整 AI 集成方案。 *注：由于价格存在变动且需保持最新，本文未提供具体定价。建议访问官方 OpenAI 价格页面了解最新信息。*