插件

通过 OpenRouter 插件扩展模型能力

OpenRouter 插件通过注入或改写请求或响应，为任意模型扩展能力，例如 PDF 处理、自动 JSON 修复和上下文压缩。与服务端工具（模型可调用 0 到 N 次）不同，插件在启用后始终只运行一次。你可以通过 API 按请求启用插件，也可以在插件设置页中将插件配置为所有 API 请求的默认项。

可用插件

OpenRouter 目前支持以下插件：

通过 API 启用插件

在聊天补全请求中加入 plugins 数组即可启用插件。每个插件由其 id 标识，并可包含可选的配置参数。

const response = await fetch('https://openrouter.ai/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer <OPENROUTER_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openai/gpt-5.2',
    messages: [
      {
        role: 'user',
        content: 'AI 领域有哪些最新进展？'
      }
    ],
    plugins: [
      { id: 'web' }
    ]
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);

同时使用多个插件

你可以在同一次请求中启用多个插件：

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

默认插件设置

组织管理员和个人用户可以配置默认插件设置，这些设置会应用于所有 API 请求。适用于：

• 默认在所有请求中启用 Web 搜索或响应修复等插件
• 无需修改应用代码即可保持插件配置一致
• 强制执行无法被单次请求覆盖的插件设置

配置默认插件设置：

1. 前往 设置 > 插件（Settings > Plugins）
2. 打开或关闭插件，以将其设为默认启用
3. 点击配置按钮自定义插件设置
4. 可选择启用「防止覆盖（Prevent overrides）」，以便在所有请求中强制使用这些设置

插件优先级

插件设置按以下优先级应用：

1. 请求级设置：各次请求 plugins 数组中的插件配置
2. 账户默认值：在插件设置页中配置的设置

如果某插件在账户默认值中已启用，但请求中未指定，将应用默认配置。如果请求中指定了该插件，这些设置会覆盖默认值。

若希望账户设置优先生效，请在该插件的配置中打开「防止覆盖」。此后，生成将无法覆盖该配置。

禁用默认插件

如果某插件已在账户设置中默认启用，你可以在该次请求的 plugins 数组中传入 "enabled": false 来禁用它：

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

即使该插件在账户默认值中已启用，这也会关闭该次请求的 Web 搜索插件。

将模型变体作为插件快捷方式

部分插件提供便捷的模型变体快捷方式。例如，在任意模型 ID 后追加 :online 即可启用 Web 搜索：

{
  "model": "openai/gpt-5.2:online"
}

这等价于：

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

有关可用快捷方式的更多信息，请参阅模型变体。