概述
TinyMCE AI 对 API 请求、上下文和附件、模型以及文件设置限制，以确保公平使用、最佳性能和成本控制。以下各部分描述了速率限制、上下文限制、特定模型的约束以及文件限制。
速率限制
速率限制用于控制请求频率，以防止滥用并确保服务稳定性。由于插件在底层使用 API，这些限制同时适用于插件使用和直接 API 调用。该服务对每分钟的请求、令牌使用、网络搜索和网页抓取请求实施限制。所有速率限制均在组织级别（较高限制）和个人用户级别（较低限制）应用，以确保公平使用。
具体速率限制值可能会有所变化，并可能因订阅层级而异。有关当前环境的速率限制详情，请联系 Tiny 支持。
处理速率限制错误
超出速率限制的请求将以 HTTP 状态码 429 Too Many Requests 和错误代码 rate-limits-exceeded 失败。错误体中的 data.limits 数组列出了请求超出的每个限制，例如 [{ "name": "messages-per-minute" }]，而 action 字段显示为 Try again later. 有关错误体的其他字段，请参阅 错误响应。API 参考中列出了此响应适用于发送会话消息和向会话添加网络资源。
上下文限制
上下文限制控制可以附加到会话的内容量，以确保 AI 模型能够有效处理所有信息。这些限制因模型而异，具体取决于它们的特定能力和处理要求。
文件限制
支持的附件类型包括 PDF、DOCX、PNG、JPEG、Markdown、HTML 和纯文本。API 接受单个上传到会话的文件大小最大为 25 MB。确切的单文件、单会话和 PDF 页面限制也取决于所使用的模型。从 GET /v1/models/{version} 读取该模型的 limits 对象（参见 验证配置模型的限制和 模型信息）。有关模式细节，请参阅 Models API OpenAPI 文档。
TinyMCE AI 插件中的文件选择器仅提供支持的附件类型。该服务强制执行文件大小和页数限制。
上下文优化提示
压缩图像并将大文档拆分为较小部分。尽可能使用文本格式（TXT 或 MD）而非 PDF，以便更好地处理。仅在会话中附加相关文件，并为非常大的文件提供文档摘要。
特定模型的限制
不同的 AI 模型具有不同的能力和限制，这些会影响上下文处理。每个模型在 GET /v1/models/{version} 响应中公开数字上限和能力标志：在 items 中找到其 id 与所用模型匹配的对象，然后读取 limits（例如上下文长度和文件大小上限，通常以字节为单位）和 capabilities。请参阅 验证配置模型的限制。
模型还具有响应超时、文件处理超时、网络资源超时和流式响应限制。
有关内容审核，请参阅 内容审核。