Gemini API 聯網搜尋使用指南

端點：   POST https://api.apiyi.com/v1beta/models/{模型名}:generateContent
工具：   tools: [{"google_search": {}}]
模型：   gemini-3.5-flash / gemini-3.1-flash-lite / gemini-3.1-pro-preview（實測驗證）

curl "https://api.apiyi.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "content-type: application/json" \
  -H "x-goog-api-key: 你的APIYI_KEY" \
  -d '{
    "contents": [{"parts": [{"text": "過去一週 AI 領域有什麼重要新聞？請搜尋後列出 3 條並附來源網址。"}]}],
    "generationConfig": {"maxOutputTokens": 4096},
    "tools": [{"google_search": {}}]
  }'

from google import genai
from google.genai import types

client = genai.Client(
    api_key="你的APIYI_KEY",                      # 預設分組即可
    http_options={"base_url": "https://api.apiyi.com"},  # 注意：不帶 /v1
)

resp = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="過去一週 AI 領域有什麼重要新聞？請搜尋後列出 3 條並附來源網址。",
    config=types.GenerateContentConfig(
        tools=[types.Tool(google_search=types.GoogleSearch())],
        max_output_tokens=4096,
    ),
)

# 1) 最終回答文本
print(resp.text)

# 2) 聯網證據：實際執行的搜尋詞與來源
gm = resp.candidates[0].grounding_metadata
if gm:
    print("搜尋詞:", gm.web_search_queries)
    for chunk in gm.grounding_chunks or []:
        print("來源:", chunk.web.title, chunk.web.uri)
else:
    print("⚠️ 本次未觸發聯網搜尋")