Skip to main content
本文說明在 API易 上使用 Grok 模型聯網搜尋(Web Search)與 X 平臺搜尋(X Search)的方法,基於 2026年7月13日 (UTC+8) 實測驗證。

一句話結論

API易 完整支援 Grok 官方 server-side 聯網工具:使用 Responses API(/v1/responses)+ web_search / x_search 工具grok-4.5 實測真實聯網、返回帶來源引用的最新資訊。預設分組的 KEY 直接可用。
舊入口已下線:Chat Completions 端點的 search_parameters 引數(舊版 Live Search)已被 xAI 移除,實測返回 410。存量程式碼請遷移到 Responses API 工具寫法。

真實可用性(實測資料,2026-07-13)

X 搜尋是 Grok 的差異化能力:可直接檢索 X(推特)平臺的即時帖子、賬號動態與話題討論,這是其他廠商聯網工具覆蓋不到的資訊源。適合輿情監控、熱點追蹤、KOL 動態分析等場景。注意 x_search 搜尋輪次多、延遲明顯更長(實測約 45 秒),客戶端超時建議設 120 秒以上。

快速上手

cURL

Python(OpenAI SDK)

X 搜尋示例

響應結構說明

output 陣列按執行順序包含: usage 中的 server_side_tool_usage_details 逐項給出各工具的實際呼叫次數(web_search_calls / x_search_calls / code_interpreter_calls / mcp_calls 等),建議在業務側記錄用於成本核對。

計費說明

聯網問答的開銷由兩部分組成:
x_search 搜尋輪次多(實測單次問答 24 次搜尋),token 注入量與延遲均高於 web_search,請按業務問答量預估成本。響應 usage 中的搜尋次數與 cached_tokens 均可自查。

注意事項

  1. 只走 Responses API:Chat Completions 的 search_parameters 已下線(410),不要再用。
  2. 延遲預期:web_search 約 12 秒、x_search 約 45 秒(實測值,隨任務複雜度浮動),客戶端超時建議 ≥ 120 秒。
  3. 控制成本:可在提示詞中約束搜尋行為(如「最多搜尋 2 次」),或在業務側監控 server_side_tool_usage_details
  4. 驗證真實聯網:檢查 output 中是否存在 web_search_call / 對應搜尋條目——只有正文、沒有搜尋條目的回答是模型憑訓練資料作答。

相關文件

Grok 概覽

模型陣容、定價與能力矩陣

程式碼執行與 MCP

同為 Responses API 的另外兩大 server-side 工具

快取計費說明

聯網注入的大量 input tokens 可配合自動快取降本

OpenAI 聯網搜尋

GPT 系列的聯網搜尋用法對照