web_search Server Tool 使模型能夠在推理過程中搜尋網頁。模型決定何時需要搜尋，ARouter 執行搜尋，結果會自動注入回模型的上下文中。
這是已棄用的 web 外掛程式和 :online 模型後綴的推薦替代方案。
快速開始
{
"model": "openai/gpt-5.4",
"messages": [{"role": "user", "content": "What happened in AI research this week?"}],
"tools": [{"type": "arouter", "arouter": {"id": "web_search"}}]
}
| 參數 | 類型 | 預設值 | 描述 |
|---|
id | string | — | 必須為 "web_search" |
max_results | integer | 5 | 回傳的最大搜尋結果數量 |
engine | string | 自動 | 搜尋引擎："native"、"exa"、"parallel" 或 "firecrawl" |
include_domains | string[] | — | 將結果限制在這些網域（支援萬用字元） |
exclude_domains | string[] | — | 排除這些網域的結果（支援萬用字元） |
max_total_results | integer | — | 限制一次請求中多次搜尋的總結果數 |
引擎選擇
| 引擎 | 描述 | 適用場景 |
|---|
| （未設定） | 如果提供商支援則使用 native，否則使用 Exa | 通用 |
"native" | 提供商內建搜尋（OpenAI、Anthropic、xAI） | 最佳引用品質 |
"exa" | Exa 的神經網路+關鍵字混合搜尋 | 研究、小眾話題 |
"parallel" | Parallel 的搜尋 API | 快速廣泛查詢 |
"firecrawl" | Firecrawl 深度爬取（BYOK） | 完整頁面內容 |
解析引用
{
"choices": [{
"message": {
"role": "assistant",
"content": "According to recent research...",
"annotations": [{
"type": "url_citation",
"url_citation": {
"url": "https://arxiv.org/abs/2501.12345",
"title": "Scaling Laws for LLMs",
"content": "We study the relationship between...",
"start_index": 32, "end_index": 96
}
}]
}
}]
}
| 引擎 | 費用 |
|---|
| Exa | 每 1,000 條結果 $4.00 |
| Parallel | 每 1,000 條結果 $4.00 |
| Native（OpenAI、Anthropic、xAI） | 按提供商費率直通 |
| Firecrawl | BYOK——使用你的 Firecrawl API key |
從 Web 外掛程式遷移
之前（已棄用）：
{"model": "openai/gpt-5.4:online", "messages": [...]}
{"model": "openai/gpt-5.4", "tools": [{"type": "arouter", "arouter": {"id": "web_search"}}], "messages": [...]}
