AI 模型

TinyMCE AI 支持来自不同提供商的多种 AI 模型。可以使用哪些模型由 JWT 中的 模型权限决定；插件配置界面、REST API 请求体以及各操作的选项（例如 快速操作自定义项）会选择在每种情况下适用的已授权模型。本页面涵盖模型能力、配置选项以及适用于插件和 API 使用方式的限制。

推荐：Agent 模型

agent-1 模型会根据速度、质量和成本自动为请求选择最佳的 AI 模型。它是大多数使用场景的推荐选择，因为它能自动优化性能和成本。

• 有关 Agent 模型所需的 token 范围，请参阅 模型权限。

• TinyMCE AI 插件中的模型选择器会将 Agent 模型显示为自动。

可用模型

TinyMCE AI 支持来自不同提供商的多种 AI 模型。每个模型都有独特的能力、性能特征和成本结构。关于未选择模型时使用的默认模型，请参阅 tinymceai_default_model。模型选择器会列出 models endpoint 返回的所有模型，包括当前 token 未授权的模型。

支持的模型

以下是可用模型及其能力的详细列表：

以下是可用模型及其能力的详细列表。在状态列中，✓ 表示启用的模型，⚠ 表示已弃用的模型及其移除日期。

限制

模型的可用性取决于订阅层级和服务兼容版本。某些模型可能有特定的限制或要求。

模型选择的工作原理

Agent 模型（agent-1）会根据以下因素自动选择最佳底层模型：

• 请求复杂性：简单的查询使用更快、更具成本效益的模型

• 内容大小：较大的内容使用具有更好上下文窗口的模型

• 所需能力：网络搜索和推理需要兼容的模型

• 成本优化：平衡质量和成本效益

当没有模型能够处理请求时，服务会返回 502 Bad Gateway 错误，代码为 no-available-models。请在几分钟后重试请求。

模型配置

JWT auth.ai.permissions 数组包括 模型权限，这些权限定义了令牌允许使用哪些模型。该允许集适用于插件和 REST API。

插件配置、API 参数和每项功能的选项不会授予对 JWT 不允许的模型的访问权限；它们只是选择在特定上下文中使用哪个允许的模型：

• JWT 模型权限：根据需要设置 ai:models:*、ai:models:agent、ai:models:<provider>:* 或 ai:models:<provider>:<model-name>。请参阅模型权限和 JWT 身份验证。

• 插件配置：tinymceai_default_model 设置默认模型，tinymceai_allow_model_selection 控制最终用户是否可以在 UI 中从允许的模型中进行选择。请参阅 聊天配置选项。

• API 请求：请求体中的 model 字段为该调用选择模型。请参阅下面的 API 示例。

• 自定义快速操作及类似功能：每个项目的选项，例如 自定义快速操作中的 model 属性，为该操作选择一个模型；该值必须在 JWT 允许的模型中。

模型与功能的集合可能会在 TinyMCE 主要版本之间发生变化。对于编辑器而言，此类变更不属于破坏性变更。请使用插件的模型选择下拉菜单或 GET /v1/models/{version} 来查看环境提供哪些模型以及模型的限制。

tinymce.init({
  selector: 'textarea',  // 请根据 HTML 修改此值
  plugins: 'tinymceai',
  toolbar: 'tinymceai-chat tinymceai-quickactions tinymceai-review',
  tinymceai_default_model: 'gemini-2-5-flash',
  tinymceai_allow_model_selection: true,
  tinymceai_token_provider: () => fetch('/api/token').then(r => r.text()).then(token => ({ token }))
});

模型兼容版本

为确保 API 的稳定性，模型按兼容版本进行组织。当引入新模型或更新现有模型时，它们可能会被添加到新的兼容版本中。请求路径包含版本号，例如 GET /v1/models/1。

工作原理

兼容版本允许 TinyMCE AI 引入新模型和新功能，而不会破坏现有集成。每个版本都维护着一组稳定的模型与功能。

TinyMCE AI 插件会请求版本 1 的模型。

检查兼容性

查看某个兼容版本的可用模型：

• 通过插件：当 tinymceai_allow_model_selection 启用时，模型选择下拉菜单会显示可用模型。配置请参阅 tinymceai_allow_model_selection。

• 通过 API：检查 GET /v1/models/{version} 端点。API 响应包含模型功能、限制与可用性。示例请参阅“模型信息”。

验证已配置模型的限制

按以下步骤读取集成中使用的 TinyMCE AI 模型的限制与功能：

• 对齐 base URL 与凭据

  • 调用与编辑器用于 TinyMCE AI 请求相同的 HTTP base URL。如果 base URL 与 JWT 不属于同一环境，响应将是授权错误而非模型元数据。

• 列出兼容版本的模型

  • 请求 GET /v1/models/1（TinyMCE AI 插件使用的兼容版本）。若要读取单个模型，请请求 GET /v1/models/1/{id}。

• 选取匹配的 items[] 条目

  • 在 JSON 的 items 数组中，选择 id 与配置中的模型（tinymceai_default_model）或 API 请求体中的模型（model）相匹配的对象。

• 读取 limits 和 capabilities

  • 查看 limits 以了解数值上限（大小以字节计）。查看 capabilities 中的 webSearch 与 reasoning，使用 enabled 和 allowed 字段。请与“模型信息”中的示例响应进行对比。

• 解读可用性标志

  • 将 allowed: false 视为“token 未包含该模型的 scope”。recommended 字段表示服务是否推荐该模型；它不会改变 limits。

“模型信息”下方提供了可直接运行的 fetch（浏览器控制台）与 curl 示例。有关字段名称及随时间发生的 schema 变更，请参阅 Models API OpenAPI 文档。

模型功能

Web 搜索与推理是可选功能，并非所有模型同时支持这两者。在模型响应中，每个模型的 capabilities 对象都包含 webSearch 与 reasoning 的条目：

• enabled：模型是否支持该功能。

• allowed：token 是否允许使用该功能（基于其 scopes）。仅当 enabled 为 true 时，此字段才会存在。

只有当所选模型报告某项功能为 allowed 时，TinyMCE AI 插件才会在 Chat 中提供 Web 搜索与推理。关于 token scopes，请参阅对话权限；对于本地部署的 AI 服务，请参阅本地部署 AI 服务的 JWT 权限。

Web 搜索

启用实时 Web 搜索以在对话过程中获取最新信息。并非所有模型都支持 Web 搜索。请检查模型功能以了解哪些模型支持此功能。

推理

API 不会返回推理文本。在模型进行推理时，数据流会发送不含文本的 reasoning 事件。某些模型的推理始终启用且无法关闭。

始终启用推理的模型：

• 推理在推理过程中始终处于活动状态。

• 推理无法通过 API 关闭。

要确定某模型是否为始终启用推理，请在列出模型时检查 API 响应，或参考插件 UI 中的模型功能。具有强制推理的模型会在其功能结构中对此进行指示。

模型名称例如 gpt-5、claude-4-sonnet 等仅为示例。实际可用模型取决于服务兼容版本。使用 GET /v1/models/1 API 端点或查看插件模型选择下拉菜单以了解当前环境中可用的模型。

网页抓取

网页抓取可从网页中提取并处理内容，以便 AI 对其进行分析和总结。当用户在聊天中将网页资源添加为上下文时，服务将获取并解析网页内容供 AI 使用。有关令牌范围，请参阅对话附件权限。网页抓取支持标准网页，且受网页资源请求的速率限制约束。

模型限制

每个模型的上限（上下文长度、附件大小、PDF 页数总和等）会在 GET /v1/models/{version} 返回的 limits 对象中列出。这些值是服务在运行时应用的限制，可能因模型而异。有关如何将集成的模型 ID 与正确的 items[] 条目匹配，请参阅“验证已配置模型的限制”。

以下部分介绍内容审核、模型描述和弃用。附件限制仅在“文件处理限制”一节中说明，并使用实时模型 API，以确保数值与服务保持一致。

文件处理限制

TinyMCE AI 在聊天对话中支持常见附件类型，包括 PDF、DOCX、图片、Markdown、HTML 和纯文本。单文件和单对话的限制（包括最大大小、附件数量、PDF 页数总和）会在 GET /v1/models/{version} 返回的每个模型的 limits 对象中列出。这些数值是服务当前应用的限制；它们可能随服务变化且因模型而异，因此请在运行时从该响应中读取集成所用各模型的 limits 对象。字段名称、单位及 schema 更新定义于Models API的 OpenAPI 文档中。

有关请求流程以及如何将已配置的模型 ID 与正确的 items[] 条目匹配，请参阅“验证已配置模型的限制”。Models API 参考文档定义了每个 limits 键。

内容审核

所有模型均包含内容审核，用于处理不当内容、有害指令、个人信息、受版权保护的材料、错误信息、敏感主题和安全威胁。当审核标记内容时，请求将失败，返回 HTTP 状态码 422 Unprocessable Content 和错误代码 unsafe-content-detected。错误主体中的 data.flaggedCategories 数组会列出被标记的类别。有关错误主体，请参阅错误响应。有关可能返回此错误的操作，请参阅API 参考文档。审核将自动应用且无法禁用。

模型描述

API 返回的模型描述默认以英文提供，并可能随时间更新以反映模型改进或功能变化。对于需要翻译模型描述的应用，请参阅下文“翻译和本地化”。

翻译和本地化

模型端点接受可选的 languageCode 查询参数（例如 GET /v1/models/1?languageCode=de），并返回翻译后的模型描述。有关支持的语言代码，请参阅Models API参考文档。

在 TinyMCE AI 插件中，模型描述遵循编辑器语言的主要语言子标签，例如 fr-FR 对应 fr，pt-BR 对应 pt，zh-TW 对应 zh。若未设置编辑器语言，则描述使用英文。

对于端点不支持的语言，可在应用代码中维护以 model.id 为键的翻译映射，并对未知模型回退到 API 返回的描述。这样在按自定义节奏添加翻译的同时，可确保新模型立即可用。

模型弃用

模型响应中的每个模型可包含两个日期：

• addition：模型开始可用的日期。在此日期之前，请求无法使用该模型。

• removal：模型被移除的日期，采用 ISO 8601 格式（例如 "removal": "2025-11-17"）。在此日期之后，指定该模型的 API 请求将失败，错误代码为 model-not-found，且模型端点不再返回该模型。

计划移除的模型会在“支持的模型”表格的状态列中以 ⚠ 及其移除日期标记。

在移除日期之后，指定已移除模型的功能将停止工作。结果取决于模型的设置位置：

• 自定义快捷操作或集成商定义的审查的 model 选项，或 API 请求的 model 字段：模型 ID 会原样发送，每个请求都会失败并返回错误代码 MODEL_NOT_FOUND。

• tinymceai_default_model：被移除的模型不再在可用模型列表中，因此 TinyMCE AI 会使用第一个可用模型并在浏览器控制台中记录一条警告。

内置的快捷操作和内置的审查不会设置模型，因此不受影响。

在移除日期之前，将每个此类设置切换到“支持的模型”表中的另一个模型，或切换到 'auto'。

要以编程方式检查已弃用的模型，请读取 GET /v1/models/{version} 中的模型列表。每个计划移除的模型都包含其 removal 日期，同一列表也可用于选择替代模型。模型信息示例请求参见下文。

API 示例

以下示例展示了直接使用 REST API 时如何配置模型。有关插件配置，请参阅 聊天模型配置。

模型选择

POST /v1/conversations/my-conversation-123/messages
Content-Type: application/json
Authorization: Bearer <your-token>

{
  "prompt": "Analyze this document and provide insights",
  "model": "agent-1",
  "content": [
    {
      "type": "document",
      "id": "doc-1234567890123"
    }
  ]
}

功能配置

POST /v1/conversations/my-conversation-123/messages
Content-Type: application/json
Authorization: Bearer <your-token>

{
  "prompt": "Research the latest developments in AI",
  "model": "gpt-5.1",
  "capabilities": {
    "webSearch": {},
    "reasoning": {}
  }
}

各功能所需的模型支持和令牌范围请参阅模型功能。

模型信息

获取兼容性版本 1 的所有可用模型。

将 <your-token> 替换为来自 JWT 身份验证 的 JWT。使用集成请求所用的同一 TinyMCE AI API 基础 URL。对于 Tiny Cloud 生产部署，该 URL 为 https://tinymceai.api.tiny.cloud。JWT 仅对签发它的 API 主机和凭据有效。

要从浏览器 DevTools 控制台（JavaScript）尝试请求，请将真实的令牌字符串替换 '<your-token>' 并使用与应用程序中相同的基础 URL。以下 fetch 和 curl 示例使用 https://tinymceai.api.tiny.cloud。

fetch('https://tinymceai.api.tiny.cloud/v1/models/1', {
  headers: { Authorization: 'Bearer ' + '<your-token>' }
}).then((r) => r.json()).then(console.log);

从终端使用 curl（请勿将 curl 粘贴到浏览器控制台—那里只应使用 fetch）：

curl -sS 'https://tinymceai.api.tiny.cloud/v1/models/1' \
  -H 'Authorization: Bearer <your-token>'

等效的 HTTP 请求：

GET /v1/models/1
Authorization: Bearer <your-token>

如果 fetch 在控制台中因 CORS 错误失败，请改为从终端运行 curl 示例，或从应用程序后端调用 API。

响应（结构示例；字段名和数值限制遵循实时服务和环境的 OpenAPI）：

{
  "items": [
    {
      "id": "agent-1",
      "name": "Agent",
      "description": "Automatically selects best model for speed, quality, and cost.",
      "provider": "Agent",
      "recommended": true,
      "allowed": true,
      "limits": {
        "maxContextLength": 256000,
        "maxFiles": 100,
        "maxFileSize": 25000000,
        "maxTotalFileSize": 30000000,
        "maxTotalPdfFilePages": 100
      },
      "capabilities": {
        "reasoning": {
          "enabled": true,
          "allowed": true
        },
        "webSearch": {
          "enabled": true,
          "allowed": true
        }
      }
    }
  ]
}

• id：tinymceai_default_model 和 API model 字段的模型标识符。

• allowed：令牌的范围是否允许该模型。

• recommended：服务是否推荐该模型。

• limits：每个模型的数值上限。大小以字节为单位，maxContextLength 是字符数。模型 API 参考定义了每个键。

• capabilities：对于 webSearch 和 reasoning，模型是否支持该功能（enabled）以及令牌是否允许它（allowed）。

addition 和 removal (可选): 模型可用和被移除的日期。请参阅模型弃用文档。

找到配置的 id 条目后，使用这些字段来验证集成（例如在上传大型附件之前或在 API 调用中启用推理之前）。

API 参考

Models API 部分的 交互式 API 文档 涵盖了模型列表、兼容版本和功能架构，以及其他 TinyMCE AI 端点。

相关功能

• 聊天: 在交互式 AI 讨论中使用模型并配置模型选择。

• 审查: 将模型应用于内容分析和改进。

• 快速操作: 使用模型执行内容转换任务。

• 插件参考: 包括模型设置在内的完整插件配置选项。