Skip to content

:online 变体已废弃。官方推荐改用 openrouter:web_search 服务器工具,该工具赋予模型自主决定何时搜索的能力,比旧的插件方式更灵活。如果你的应用已经提供 web_search 工具,可以直接移除 :online 后缀,网络搜索功能会自动通过服务器工具生效。

已废弃:online 变体已废弃,请改用 openrouter:web_search 服务器工具

迁移指南

如果你的应用已经在使用 OpenAI 内置的 web_search 工具类型,OpenRouter 会自动将其识别并提升为 openrouter:web_search 服务器工具。

迁移步骤:

  1. 移除模型 slug 中的 :online 后缀
  2. 确保应用中提供了 web_search 工具
  3. 网络搜索功能会自动通过服务器工具继续工作

旧用法(已废弃)

旧版用法是在模型 ID 末尾加 :online,等价于使用 web 插件:

json
// 旧用法(不推荐)
{ "model": "openai/gpt-4o:online" }

// 等价的插件方式(也已废弃)
{
  "model": "openrouter/auto",
  "plugins": [{ "id": "web" }]
}

推荐替代方案

常见问题

Q: 我现在还在用 :online,会立刻失效吗?

A: 目前仍然可用,但官方已不推荐,未来可能移除。建议尽快迁移到服务器工具方式。

Q: 新的服务器工具方式有什么优势?

A: 服务器工具让模型自己判断何时需要搜索,避免不必要的搜索请求,降低延迟和成本,且适用于所有模型。