Recherche Google avec Gemini

Cette page explique comment activer la recherche Google pour Gemini et lire les sources. Les ID de modèle et les adresses d’endpoint figurent dans la présentation de la famille Gemini.

Une fois la recherche Google activée, le modèle effectue des recherches sur le web et répond à partir des résultats ; c’est utile pour les informations qui évoluent dans le temps.

Python (google-genai)

gemini_grounding.py


import os
from google import genai
from google.genai import types
 
client = genai.Client(
    api_key=os.environ["OFOX_API_KEY"],
    http_options={"api_version": "v1beta", "base_url": "https://api.ofox.io/gemini"},
)
 
resp = client.models.generate_content(
    model="google/gemini-3.5-flash",
    contents="Quelle est la dernière version stable de Python ?",
    config=types.GenerateContentConfig(tools=[types.Tool(google_search=types.GoogleSearch())]),
)
print(resp.text)
meta = resp.candidates[0].grounding_metadata
print("Requêtes de recherche :", meta.web_search_queries)
for chunk in meta.grounding_chunks or []:
    print("Source :", chunk.web.title, chunk.web.uri)

cURL

Terminal


curl "https://api.ofox.io/gemini/v1beta/models/google/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Quelle est la dernière version stable de Python ?"}]}],
    "tools": [{"google_search": {}}]
  }'

Python (SDK OpenAI)

gemini_grounding_openai.py


import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.io/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="google/gemini-3.5-flash",
    web_search_options={},
    messages=[{"role": "user", "content": "Quelle est la dernière version stable de Python ?"}],
)
print(resp.choices[0].message.content)

Dans la réponse de l’API native, groundingMetadata contient les requêtes de recherche (webSearchQueries) et les pages sources (groundingChunks).
L’API compatible OpenAI ne renvoie que la réponse, sans les sources.
Les recherches sont facturées à l’unité, au prix indiqué sur la page du modèle .

Les autres erreurs sont décrites dans Erreurs courantes.