OpenRouter Plugins 是一套模型能力扩展机制，通过在请求或响应阶段注入/变换数据来添加功能，如网页搜索、PDF 解析、JSON 修复和上下文压缩。与 Server Tools（模型按需调用）不同，Plugins 在启用时必然运行一次。可在单次请求中通过 plugins 数组启用，也可在账户设置中配置默认行为。

OpenRouter 插件（Plugins）

OpenRouter Plugins 通过在请求或响应阶段注入/变换数据，为任何模型添加额外能力——如 PDF 解析、JSON 自动修复、上下文压缩等。与 Server Tools（模型可按需调用 0 到 N 次）不同，Plugins 在启用时总是运行一次。

可用插件

插件	说明	文档
Web Search（已废弃）	用实时网页搜索结果增强响应。推荐改用 openrouter:web_search server tool	Web Search
PDF Inputs	解析并提取上传 PDF 文件中的内容	PDF 输入
Response Healing	自动修复 LLM 返回的格式错误 JSON	Response Healing
Context Compression	使用中间截断算法压缩超出上下文窗口的 Prompt	Message Transforms

通过 API 启用插件

在 chat completions 请求中添加 plugins 数组，每个插件由 id 标识，可携带可选配置参数：

{
  "model": "openai/gpt-4o",
  "messages": [
    { "role": "user", "content": "最近 AI 有什么新进展？" }
  ],
  "plugins": [
    { "id": "web" }
  ]
}

同时启用多个插件

{
  "model": "openai/gpt-4o",
  "messages": [...],
  "plugins": [
    { "id": "web", "max_results": 3 },
    { "id": "response-healing" }
  ],
  "response_format": {
    "type": "json_schema",
    "json_schema": { ... }
  }
}

配置默认插件

组织管理员和个人用户可以在设置页面配置全局默认插件，对所有 API 请求生效，无需在每次请求中重复指定：

1. 前往 Settings > Plugins
2. 开启/关闭插件以设置默认状态
3. 点击配置按钮自定义插件参数
4. 可选择开启 "Prevent overrides"，强制所有请求使用该配置

在组织账户中，只有管理员可以访问 Plugins 设置页面。

插件优先级

1. 请求级参数：单次请求中 plugins 数组的配置
2. 账户默认值：Plugins 设置页面中配置的默认值

请求级配置优先于账户默认值。若开启了 "Prevent overrides"，则账户默认值强制生效，无法被请求级参数覆盖。

在单次请求中禁用默认插件

若某插件在账户设置中默认开启，可通过传入 "enabled": false 在特定请求中禁用：

{
  "model": "openai/gpt-4o",
  "messages": [...],
  "plugins": [
    { "id": "web", "enabled": false }
  ]
}

模型变体快捷方式

部分插件支持通过模型变体快捷方式启用。例如，在任意 model ID 后追加 :online 即可启用网页搜索：

{ "model": "openai/gpt-4o:online" }

等同于：

{
  "model": "openai/gpt-4o",
  "plugins": [{ "id": "web" }]
}

更多模型变体快捷方式请参阅 Model Variants。

---

常见问题

Q: Plugins 和 Server Tools 有什么区别？

A: Server Tools 让模型在生成过程中按需决定"是否调用"以及"调用多少次"；Plugins 是无条件运行的——只要在请求中启用，就必然执行一次，对请求或响应进行预处理或后处理。

Q: 可以同时启用多个插件吗？

A: 可以。在 plugins 数组中列出多个插件即可，OpenRouter 会依次处理。例如同时启用 web 和 response-healing 是常见组合。

Q: "Prevent overrides" 适合什么场景？

A: 适合需要在组织范围内强制执行某些策略的场景，例如要求所有请求都走 Response Healing 保证 JSON 格式，或禁止任何请求关闭合规相关的插件。