Solutions / 网络搜索

让模型回答前，
先查一下网络

在模型名称后加上 :online，或在请求里开启网络搜索，BazaarLink 会先替你搜索，把找到的内容与来源交给模型，回答时附上可以点开的引用链接。

三种开启方式，任选其一

三种写法效果相同，搜索由 BazaarLink 处理，这些参数不会原样转给模型。chat/completions、responses、messages 三个端点都支持，流式与非流式均可。

模型名称加上 :online

最简单的写法：在支持的模型 ID 后面加上 :online。

{
  "model": "openai/gpt-4o-mini:online",
  "messages": [
    { "role": "user", "content": "What changed in the EU AI Act this month?" }
  ]
}

plugins

在 plugins 带一个 id 为 web 的项目，也可以用 max_results 调整取回的来源数量（有上限）。

{
  "model": "openai/gpt-4o-mini",
  "plugins": [{ "id": "web", "max_results": 5 }],
  "messages": [
    { "role": "user", "content": "What changed in the EU AI Act this month?" }
  ]
}

web_search_options

用 search_context_size 选择搜索等级：low、medium（默认）或 high。

{
  "model": "openai/gpt-4o-mini",
  "web_search_options": { "search_context_size": "high" },
  "messages": [
    { "role": "user", "content": "What changed in the EU AI Act this month?" }
  ]
}

参数格式与 OpenRouter 兼容：已经用 OpenRouter 写法开启网络搜索的程序，把 base URL 换成 BazaarLink 就能继续使用。

自带密钥（BYOK）、自有算力（BYOC）也能搜索

用自己的上游密钥或自己的机器跑模型，一样加 :online 就能先查网络再回答。搜索在平台端完成，结果连同问题交给你的密钥或节点处理。

BYOK

你的密钥处理

模型费用不经 BazaarLink 收取，只收搜索费。

了解 BYOK

BYOC

你的节点处理

模型费零计价，只收搜索费。

了解 BYOC

搜索费按平台价格计算，账户需有足够余额支付；若请求改由平台模型处理，模型费按平台费率另计。

搜索等级

low: 取回较少来源，适合只需要快速确认的问题。
medium（默认）: 一般用途的默认等级。
high: 使用更深入的搜索，适合需要比对多方资料的问题；单价较高。

如何计费

按次计费，按平台定价

每次网络搜索按平台定价计费，另外加上模型本身的费用；high 等级的搜索单价较高。

免费模型也收搜索费

模型本身免费，但网络搜索仍按平台定价计费。

搜索失败不收费

搜索服务暂时无法使用时，请求会返回 503（web_search_unavailable），不会调用模型，也不收搜索费；模型最终没有成功生成回应时，同样不收搜索费。

搜索前被拦下就不会搜索

余额不足、参数错误等在搜索前就被拦下的请求，不会进行搜索，也不会产生搜索费。

回答附上来源

每个被参考的来源会以一条 url_citation 放在 annotations 里，包含网址、标题与内容摘要，方便你在界面上显示引用。

"message": {
  "role": "assistant",
  "content": "…",
  "annotations": [
    {
      "type": "url_citation",
      "url_citation": {
        "url": "https://example.com/article",
        "title": "Example article",
        "content": "Source excerpt…",
        "start_index": 0,
        "end_index": 0
      }
    }
  ]
}

chat/completions：非流式放在 choices[].message.annotations；流式时在 [DONE] 之前多发送一个只带 delta.annotations 的数据块。
responses：放在 output_text 的 annotations；messages：附在文本内容块的 annotations。
回答文本不会自动插入 [1] 这类标记。模型若在回答中标注了来源，start_index 与 end_index 会指向那段文字；没有标注时两者都是 0。

完整参数与示例

所有参数、错误码与各端点的完整示例，都整理在文档的网络搜索章节。

查看网络搜索文档

在下一个请求加上 :online 试试

不需要另外申请，用现有的 API key 就能开始；搜索费用从账户余额扣除。

获取 API key

让模型回答前，先查一下网络