--- title: "AI 生成编辑器命令" description: "将 AI 集成到您的 Tiptap 编辑器中，访问预配置的文本操作和图像生成命令。" canonical_url: "https://tiptap.zhcndoc.com/content-ai/capabilities/generation/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，或查看[自定义大语言模型指南](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/custom-llms.md)。 - **3. 从私有注册表安装** 要安装前端扩展，请按照[设置指南](https://tiptap.zhcndoc.com/guides/pro-extensions.md)进行身份验证，连接至 Tiptap 的私有 npm 注册表。 Tiptap 编辑器的 AI 生成扩展提供了一组预配置的命令，您可以将它们集成到富文本编辑器中。这些命令允许您调整文本语气、文本补全、生成图像等，增强编辑器功能。 欲了解这些命令的使用示例，请参阅[概览](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/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) | 生成“TL;DR”（太长，没看完）版本文本 | | [`aiTranslate(language: Language, options: TextOptions)`](#aitranslate) | 将选中文本翻译为指定语言 | | **辅助命令** | | | [`aiAccept(options: AcceptOptions)`](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/manage-responses.md#aiaccept) | [接受生成的响应](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/manage-responses.md)，并插入编辑器 | | [`aiReject(options: RejectOptions)`](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/manage-responses.md#aireject) | [拒绝生成的响应](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/manage-responses.md)，并重置 ai.storage 状态 | | [`aiRegenerate(options: RegenerateOptions)`](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/manage-responses.md#airegenerate) | [重新生成响应](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/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` 的每个命令，您可以指定以下选项： | 设置项 | 类型 | 默认值 | 说明 | | ---------------- | ---------------------------------------------------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------- | | `modelName` | 见[支持的文本模型](#支持的文本模型) | `gpt-3.5-turbo` | 使用的 OpenAI 模型 | | `format` | `'rich-text' \| 'plain-text'` | `plain-text` | 决定模型响应的[格式](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/text-generation/format.md) | | `stream` | `boolean` | `false` | 是否将字符流式传输到编辑器？其效果类似 ChatGPT 中的“打字机”行为。**这需要最新版本的扩展！** | | `insertAt` | `undefined \| number \| {from: number; to: number}` | `undefined` | 将响应插入编辑器的具体位置。如果为 `undefined`，响应将插入当前选区；如果为数字，响应将插入至该位置；如果为对象，则替换该范围内内容。 | | `language` | `string`（例如 `en`、`de`） | `null` | 虽然我们会尽力让 OpenAI 以输入语言响应，有时自己定义语言更准确。 | | `tone` | `string` | `null` | 应当转换为的[语气](#aiadjusttone) | | `textLength` | `number` | `undefined` | AI 应生成的文本长度数量（例如“3段”中的数字3） | | `textLengthUnit` | `'paragraphs' \| 'words' \| 'characters'` | `undefined` | 文本长度的单位（例如“3段”中的“段落”） | | `collapseToEnd` | `boolean` | `true` | 操作完成后光标是否移动到文本末尾，或插入内容是否被选中。 | | `context` | `Array<{ type: 'text', text: string} \| { type: 'url', url: string }>` | `[]` | 为模型生成响应提供的[上下文](https://tiptap.zhcndoc.com/content-ai/capabilities/generation/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 价格页面了解最新信息。*