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

讓模型回答前，先查一下網路