LLM API 聯網搜尋怎麼加?模型名稱加 :online 就好
在模型名稱後加 :online 或設定 plugins,就能讓任何模型取得最新搜尋結果並附上來源。含範例程式、搜尋深度、篩選條件與計費規則,台幣計價、可開統一發票。
語言模型只知道訓練時學到的內容。價格、版本更新、新聞、函式庫最新的 API,這些訓練之後才變的資料,它只能猜。常見做法是自己接一段搜尋流程:挑一個搜尋 API、呼叫、整理結果、貼進 prompt,再祈禱模型有引用來源。
BazaarLink 把這件事縮成對現有請求的一個小改動。
最短做法
在模型名稱後面加上 :online:
curl https://bazaarlink.ai/api/v1/chat/completions \
-H "Authorization: Bearer $BAZAARLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "openai/gpt-6-luna:online",
"messages": [{"role": "user", "content": "最新的 Node.js LTS 改了什麼?"}]
}'
系統會先搜尋,把結果交給模型,回覆時附上引用來源。
三種等效的開啟方式
| 方式 | 適合的情況 |
|---|---|
"model": "<模型>:online" | 想改動最少。任何模型 ID 都能用。 |
"plugins": [{"id": "web", "max_results": 5}] | 想指定每次請求要幾筆來源。 |
"web_search_options": {"search_context_size": "high"} | 已經在用 OpenAI 格式的選項,想選搜尋深度。 |
三種可以同時寫,但每個請求只會執行一次搜尋。Chat Completions、Responses、Messages 三種端點都支援,串流與非串流都可以。
選擇搜尋深度
用 search_context_size 指定:
| 等級 | 深度 | 預設筆數 | 適合 |
|---|---|---|---|
low | 標準 | 5 | 快速查證一件事 |
medium(預設) | 標準 | 10 | 一般問題 |
high | 進階 | 10 | 多來源比較、研究 |
fast | 快速 | 10 | 重視回應速度的聊天 |
越深的等級,單次搜尋費用越高。搜尋與模型 token 分開,按次計費。
縮小搜尋範圍
同一個 plugin 或 options 物件裡可以加:
| 選項 | 值 | 效果 |
|---|---|---|
country | 例如 taiwan、japan | 優先取用該地區的來源 |
language | ISO 639-1,例如 zh | 優先取用該語言 |
topic | general、news | 切換成新聞類結果 |
time_range | day、week、month、year | 只取近期內容 |
max_results | 1–10 | 引用筆數 |
query_source | last_user、conversation | 搜尋最後一句,或整段對話 |
search_prompt | 文字 | 自己指定搜尋關鍵字 |
範例:查上週的新聞,優先台灣來源,取 3 筆:
{
"model": "claude-sonnet-5.5",
"messages": [{"role": "user", "content": "AI 監管最新動態"}],
"plugins": [{
"id": "web",
"max_results": 3,
"topic": "news",
"time_range": "week",
"country": "taiwan"
}]
}
讀取引用來源
來源會以 url_citation 物件放在 annotations 裡:
{
"type": "url_citation",
"url_citation": {
"url": "https://example.com/article",
"title": "文章標題",
"content": "來源摘要內容…",
"start_index": 0,
"end_index": 0
}
}
如果模型沒有把來源對應到回答的某一段,start_index 與 end_index 都會是 0。串流時,annotations 會在 [DONE] 之前一次送出。
什麼情況不收費
- 搜尋失敗(HTTP 503
web_search_unavailable)不收費 - 餘額不足、在搜尋之前就被拒絕,不收費
- 搜尋後模型生成失敗,不收這次搜尋費
- 一次送多組查詢時,只收成功的那幾組
- 免費模型仍會有搜尋費,因為搜尋是獨立的計費項目
用台幣計價、可開統一發票
BazaarLink 以新台幣儲值與計價,可開立統一發票,方便公司報帳。不必為了搜尋另外申請國外服務的帳號、也不必處理外幣付款。
從現有程式搬過來
參數格式與常見的 OpenRouter 風格聯網搜尋選項相容。如果你的程式已經在用 :online 或 web plugin,只要換 base URL 與 API key 即可。
適合的場景
- 需要引用最新價格或條款頁面的客服、業務助理
- 需要讀最新函式庫文件的 coding 助理
- 需要附日期與可點擊來源的研究型 agent
- 原本依賴已停用的搜尋 API、需要找持續維護的替代方案的流程
取得 API key,下一次請求就試試 :online。完整選項請看文件的「網路搜尋」章節。
四個工具的用法與價格,見〈Tavily 風格 AI 搜尋 API:Search、Extract、Crawl、Map〉。