結論先說
- 開啟只需在
tools裏聲明google_search工具:Interactions API 傳tools=[{"type": "google_search"}],模型會自動判斷是否需要檢索並自行生成一條或多條搜尋詞。 - 返回結果自帶字符級精確引用座標:在 Interactions API 中讀取文本塊的
annotations(類型為url_citation,含start_index、end_index、title與url);在generateContent中則讀取grounding_metadata。 - 付費層每月提供 5,000 次免費搜尋請求(跨 Gemini 3 及更新模型共享),超出後按每 1,000 次請求
14 美元計費,預設每日上限為1,500次請求。 - 只有模型實際發起了檢索才會產生搜尋工具調用記錄;普通邏輯推理或無需聯網的提問雖然掛着工具,但未觸發搜尋時不扣搜尋配額。
- 谷歌帳號準備與多工具訂閱入口:使用 Gemini、Google AI Studio 與 Antigravity 需具備符合地區與年齡要求的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 的 谷歌電郵成品號),跨平台付費訂閱總覽見 AI 會員充值中心。

圖:本站根據 Google Gemini API 文檔:Grounding with Google Search 整理的示意圖
本文根據 Google Gemini API 官方文檔《Grounding with Google Search》《Gemini Developer API Pricing》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Google 官方網站。
適用於誰
- 想讓基於 Gemini API 開發的應用回答最新新聞、賽事比分、股價動態或新發布技術文檔,減少模型幻覺的開發者;
- 調通了聯網回答,卻不知道怎麼從返回 JSON 裏提取來源連結做前端角標高亮的人;
- 需要核算生產環境成本,想弄清每月免費搜尋次數、每千次單價與每日配額上限的團隊。
一、開啟參數:Interactions API 與 generateContent 寫法
如果你先在網頁沙盒測試聯網效果,操作入口見 Google AI Studio 系統指令與運行設定。遷移到代碼調用時,官方 SDK(安裝見 Gemini API Python 調用教學)支持以下兩種主流接口:
1. Interactions API(推薦新一代接口)
python
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-4-hydrogen",
input="2026 年最新發布的 TypeScript 主版本有哪些核心改動?",
tools=[{"type": "google_search"}],
)
print(interaction.output_text)
2. generateContent 接口寫法
如果現有工程基於 models.generate_content 構建,則在配置對象中掛載 google_search:
python
from google import genai
from google.genai import types
client = genai.Client()
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="查詢本週美聯儲議息會議的最新利率決議結果",
config=types.GenerateContentConfig(
tools=[types.Tool(google_search=types.GoogleSearch())]
),
)
print(response.text)
需要註冊 Google 帳號前往 AI Studio 創建 API Key 時,也可在本站查看 谷歌帳號說明。
二、解析引用來源元數據與展示搜尋入口
開啟聯網後,把出處連結渲染到介面上不僅方便用戶核驗真偽,也是合規展示的重要一環。按接口不同,返回結構對應關係如下:
| 元數據內容 | Interactions API 字段位置 | generateContent 字段位置 |
|---|---|---|
| 模型實際搜了什麼詞 | google_search_call 步驟的 arguments.queries | grounding_metadata.web_search_queries |
| 網頁標題與目標 URL | 文本塊 annotations 裏的 title 與 url | grounding_metadata.grounding_chunks |
| 正文對應字符起止位置 | url_citation 的 start_index / end_index | grounding_metadata.grounding_supports |
| 搜尋建議掛件 HTML | google_search_result 的 search_suggestions | grounding_metadata.search_entry_point |
以 Interactions API 為例,提取每句話對應引用來源的 Python 代碼如下:
python
for step in interaction.steps:
if step.type == "model_output":
for block in step.content:
if block.type == "text" and block.annotations:
for ann in block.annotations:
if ann.type == "url_citation":
snippet = block.text[ann.start_index:ann.end_index]
print(f"原文片段: {snippet} -> 來源: {ann.title} ({ann.url})")
注意按 Google 服務條款關於 Grounding with Google Search 的展示要求,商業應用面向外部用戶展示聯網回答時,還應將返回的 search_suggestions(或 search_entry_point)HTML 搜尋建議組件按規範渲染在介面中。橫向對比 OpenAI 與 Claude 的聯網接口寫法,可查閱 OpenAI API 聯網搜尋工具怎麼用 與 Claude API 聯網搜尋工具怎麼用。

圖:本站根據 Google Gemini API 文檔:Gemini Developer API Pricing 整理的示意圖
谷歌開發帳號與主力編程訂閱提示:若當前帳號卡在地區不支持、手機核驗或工作空間限制,可在本站選購已配置兩步驗證的 谷歌帳號成品號(即時發貨,質保首登,到手請按指引先登後改密);日常搭配主力模型開發,也可同步了解免境外卡自助兌換的 ChatGPT Plus 與 Claude Pro。
三、計費規則、免費額度與每日配額上限
除常規的模型輸入輸出 token 費用外,聯網搜尋工具在付費層(Paid Tier)按請求獨立核算:
- 每月免費贈送額度:付費層項目每月包含 5,000 次免費搜尋請求,該額度在項目下所有受支持的 Gemini 3 及更新代際模型之間共享;
- 超額按量單價:當月超過 5,000 次後,按 每 1,000 次請求 14 美元 計收工具費;
- 每日保護上限(Daily Cap):為防代碼死循環刷爆帳單,官方預設設定每個項目每天最多 1,500 次搜尋請求(1,500 RPD),業務量增大時可在 Google AI Studio 配額頁面申請調高。完整模型 token 費率見 Gemini API 價格。
常見問題
問:我已經傳了 google_search,為什麼返回結果裏沒有 annotations 引用?
答:掛載工具代表「允許模型聯網」,不代表強制搜尋。如果問的是常識性編程語法(如冒泡排序怎麼寫),模型認為自身知識足夠解答就不會觸發 google_search_call,自然也不會返回網頁引用。需要查實時資訊時可在提示詞裏明確寫「請聯網檢索最新官方公告並附上來源」。
問:能不能同時指定某幾個特定網頁讓它讀,又允許它全網搜尋?
答:可以。官方文檔說明 Grounding with Google Search 支持與 URL Context 工具組合傳入,讓模型既能精讀你給出的指定 URL 正文,又能補充檢索公開網頁資訊。
問:一次對話裏模型自動拆了 3 個搜尋詞,怎麼判斷觸發了聯網?
答:查看返回的 steps 中是否包含 "type": "google_search_call"(或檢查 web_search_queries 是否非空),裏面會完整列出本輪模型實際下發的查詢詞數組。
問:沒有可用的個人谷歌帳號,或者同時想開其他主流 AI 會員怎麼辦?
答:本站提供即買即發的 谷歌電郵成品號(登入方法見 谷歌帳號購買頁),同時支持支付寶、微信支付與 AlipayHK 自助充值 ChatGPT Plus、Claude Code 等主流服務,實時價格與質保細則以各商品頁說明為準。
相關教學
- Gemini API 價格:各模型每百萬 tokens 多少錢、免費層和付費層差在哪
- Google AI Studio 系統指令怎麼寫:System instructions 與運行設定(思考等級、溫度、聯網搜尋)
- OpenAI API 聯網搜尋工具(web search)怎麼用
- Claude API 聯網搜尋工具(web search tool)怎麼用
參考資料
- Google Gemini API 官方文檔:Grounding with Google Search(Interactions API) — https://ai.google.dev/gemini-api/docs/google-search
- Google Gemini API 官方文檔:Grounding with Google Search(generateContent) — https://ai.google.dev/gemini-api/docs/generate-content/google-search
- Google Gemini API 官方文檔:Gemini Developer API Pricing — https://ai.google.dev/gemini-api/docs/pricing
0 條評論
還沒有評論,來搶沙發~