Appearance
:online 变体已废弃。官方推荐改用 openrouter:web_search 服务器工具,该工具赋予模型自主决定何时搜索的能力,比旧的插件方式更灵活。如果你的应用已经提供 web_search 工具,可以直接移除 :online 后缀,网络搜索功能会自动通过服务器工具生效。
已废弃:
:online变体已废弃,请改用openrouter:web_search服务器工具。
迁移指南
如果你的应用已经在使用 OpenAI 内置的 web_search 工具类型,OpenRouter 会自动将其识别并提升为 openrouter:web_search 服务器工具。
迁移步骤:
- 移除模型 slug 中的
:online后缀 - 确保应用中提供了
web_search工具 - 网络搜索功能会自动通过服务器工具继续工作
旧用法(已废弃)
旧版用法是在模型 ID 末尾加 :online,等价于使用 web 插件:
json
// 旧用法(不推荐)
{ "model": "openai/gpt-4o:online" }
// 等价的插件方式(也已废弃)
{
"model": "openrouter/auto",
"plugins": [{ "id": "web" }]
}推荐替代方案
- 新方式:Web Search 服务器工具 — 让模型自主控制何时及多频繁地搜索
- 旧插件方式:Web Search 插件文档 — 仅供遗留代码参考
常见问题
Q: 我现在还在用 :online,会立刻失效吗?
A: 目前仍然可用,但官方已不推荐,未来可能移除。建议尽快迁移到服务器工具方式。
Q: 新的服务器工具方式有什么优势?
A: 服务器工具让模型自己判断何时需要搜索,避免不必要的搜索请求,降低延迟和成本,且适用于所有模型。