Zoekfunctie op het web inschakelen in de Grok API
Op deze pagina
Bijgewerkt op 2 november 2026. Gebaseerd op de xAI-documentatie: met de
xai-sdkwordt zoeken op het web geactiveerd via de functieweb_search()die wordt geïmporteerd uitxai_sdk.tools, binnen een conversatie die is gemaakt metclient.chat.create; het oude voorbeeld riepclient.tools.web_search()aan, wat niet bestaat in deze SDK. Bron: Web Search.
Bijgewerkt op 3 november 2026. Het eerste voorbeeld riep
client.responses.create()aan op dexai-sdk-client, maar deze heeft geenresponses-attribuut: met deze SDK verloopt zoeken viaclient.chat.create(..., tools=[web_search()]), terwijlclient.responses.create()behoort tot deopenai-SDK die wijst naarhttps://api.x.ai/v1. Het Vercel AI SDK-voorbeeld gaf tools door als een array en importeerdegenerateTextniet: ze declareren deze in een object, zoals in de xAI-documentatie. Code geverifieerd metxai-sdk1.21.0 enopenai3.42.1. Bron: Web Search.
Waarom Grok verbinden met het realtime web
Klassieke taalmodellen werken met kennis die bevroren is op hun trainingsdatum. Voor een ontwikkelaar die applicaties bouwt die actuele gegevens vereisen (beurskoersen, nieuws, sportuitslagen, weer), is deze beperking een dealbreaker. De web_search-tool in de Grok API lost dit probleem op door het model in staat te stellen het web in realtime te doorzoeken, direct vanuit uw API-aanroep.

In tegenstelling tot andere aanbieders die integraties van derden of aparte plugins vereisen, biedt xAI zoeken op het web als een ingebouwde tool aan de serverzijde. U hoeft geen infrastructuur te beheren: het model beslist wanneer er gezocht moet worden, voert de query uit en integreert de resultaten in zijn antwoord.
De Responses API: het enige ondersteunde eindpunt
Zoeken op het web werkt uitsluitend op de Responses API. Het oude Chat Completions-eindpunt bood een parameter search_parameters, maar deze is inmiddels verouderd. Als u migreert vanaf de oude API, moet u uw aanroepen aanpassen.
Activering gebeurt door de tool web_search toe te voegen aan de array tools in uw verzoek:
import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["XAI_API_KEY"], base_url="https://api.x.ai/v1")
response = client.responses.create(
model="grok-4.5",
input="What is the weather like in Paris today?",
tools=[{"type": "web_search"}],
)
print(response.output_text)
Dit voorbeeld gebruikt de openai-SDK, die compatibel is met de xAI Responses API; de native xAI SDK, die hieronder wordt gepresenteerd, verloopt via een conversatie.
Dat is alles. Het model analyseert uw prompt, bepaalt of het verse informatie nodig heeft en start de zoekopdracht automatisch. U hoeft geen lus voor aanroepen of conditionele logica te beheren.
De uitvoeringsstroom in vijf stappen
Wanneer u een verzoek verzendt met web_search ingeschakeld, volgt het proces een specifieke volgorde:
- Analyse: het model evalueert of de vraag recente gegevens vereist
- Beslissing: het kiest ervoor om te zoeken of te antwoorden met zijn interne kennis
- Uitvoering: zoeken op het web wordt server-side uitgevoerd (u beheert niets)
- Verwerking: resultaten worden geanalyseerd en samengevat
- Antwoord: de definitieve tekst wordt gegenereerd met bijbehorende citaten
Dit mechanisme betekent dat het model kan besluiten niet te zoeken als de vraag dit niet rechtvaardigt. Als u bijvoorbeeld vraagt naar de definitie van fotosynthese, zal dit waarschijnlijk geen zoekopdracht op het web activeren.
Gebruik met verschillende SDK’s
De xAI SDK biedt een speciale functie, web_search(), om door te geven aan de lijst met conversatietools:
# Native xAI SDK
from xai_sdk import Client
from xai_sdk.chat import user
from xai_sdk.tools import web_search
client = Client()
chat = client.chat.create(model="grok-4.5", tools=[web_search()])
chat.append(user("Latest AI news in Europe"))
response = chat.sample()
print(response.content)
print(response.citations)
Met de openai-SDK is het de aanroep vanaf het begin van de les: client.responses.create() met base_url="https://api.x.ai/v1" en tools=[{"type": "web_search"}].
Voor de Vercel AI SDK in JavaScript:
import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';
const { text, sources } = await generateText({
model: xai.responses('grok-4.5'),
prompt: "Latest AI news in Europe",
tools: {
web_search: xai.tools.webSearch(),
},
});
console.log(text);
console.log('Citations:', sources);
Praktijkoefening
Maak een script dat Grok ondervraagt over een actuele gebeurtenis naar keuze. Verifieer dat het antwoord recente informatie bevat (data, gebeurtenissen die plaatsvonden na de cutoff-datum van het model). Probeer vervolgens dezelfde vraag zonder de tool web_search om het verschil te zien.
Belangrijkste punten
- Zoeken op het web wordt geactiveerd met
{"type": "web_search"}intools(openai-SDK, Responses API) ofweb_search()inclient.chat.create(xai-sdk) - Het werkt alleen op de Responses API (niet op Chat Completions)
- Het model beslist autonoom wanneer het moet zoeken
- Citaten worden automatisch opgenomen in het antwoord
- De kosten bedragen $5 per 1.000 tool-aanroepen, plus de verbruikte tokens