Ein Sprachmodell kennt nur den Stand seiner Trainingsdaten. Für aktuelle Preise, Öffnungszeiten oder Nachrichten kannst du die Websuche des Anbieters einschalten. Das Modell sucht dann selbst im Web und liefert dir die Quellen mit. Die Websuche ist bei FlowModels standardmäßig aus, weil jede Suche zusätzlich berechnet wird.
Websuche einschalten
Setze in der Anfrage web_search auf true. Das funktioniert bei /chat/completions und bei /responses:
{
"model": "xai/grok-4.7",
"web_search": true,
"messages": [{"role": "user", "content": "Welche Feiertage gibt es im Dezember in Hamburg?"}]
}
Die Modellkennung ist hier nur ein Beispiel. Nicht jedes Modell bringt eine eigene Websuche mit. In GET /v1/models siehst du unter capabilities:
web_search: true: Das Modell kann suchen, wenn du es einschaltest.web_search_forced: true: Das Modell sucht immer, die Suche ist fest eingebaut. Das gilt zum Beispiel für die Modelle von Perplexity.
Ein Modell ohne Websuche lehnt web_search: true mit 400 unsupported_for_model ab. Umgekehrt lehnt ein Modell mit fest eingebauter Suche web_search: false ab, damit du nicht glaubst, die Suche sei aus, während sie trotzdem berechnet wird.
Wenn du die OpenAI-Bibliothek für Python nutzt, gibst du web_search und search_domain_filter über extra_body mit, siehe Die OpenAI-Bibliothek für Python und Node.js mit FlowModels nutzen.
Die Suche auf bestimmte Domains begrenzen
Mit search_domain_filter steuerst du, wo gesucht wird. Das Feld schaltet die Websuche automatisch mit ein.
- Nur bestimmte Seiten:
"search_domain_filter": ["deine-firma.de", "hilfe.deine-firma.de"] - Bestimmte Seiten ausschließen:
"search_domain_filter": ["-reddit.com", "-pinterest.com"]
Dabei gelten ein paar Regeln:
- Entweder nur Freigaben oder nur Ausschlüsse, nicht beides gemischt.
- Domains ohne
https://und ohne Pfad angeben. Subdomains sind automatisch eingeschlossen. - Höchstens 20 Domains. Manche Modelle nehmen weniger an, bei xAI sind es 5. Die genaue Zahl steht in
capabilities.web_search_domain_filter_max. - Steht dort
0, unterstützt das Modell keinen Domainfilter. Gemini gehört zum Beispiel dazu. Die Anfrage wird dann mit400 unsupported_for_modelabgelehnt.
Ein typischer Einsatz ist ein Hilfe-Bot, der nur auf deiner eigenen Website nachschlagen soll.
Die Quellen auslesen
Hat das Modell gesucht, enthält die Antwort zwei zusätzliche Felder:
citations: eine Liste der Adressen, die das Modell verwendet hatsearch_results: je Quelletitle,urlunddate
"citations": ["https://www.example.de/feiertage-hamburg"],
"search_results": [{"title": "Feiertage in Hamburg", "url": "https://www.example.de/feiertage-hamburg", "date": "2026-10-02"}]
Beim Streaming stehen beide Felder im letzten Chunk vor [DONE]. Ohne Suche fehlen sie ganz. Zeig deinen Nutzern die Quellen am besten mit an, dann können sie die Angaben selbst prüfen.
Was die Suche kostet
Die Suche wird zusätzlich zu den Tokens berechnet. Den Gesamtbetrag einer Anfrage siehst du in der Antwort unter usage.cost und im Anfrageprotokoll. Mehr zu den Kosten einer Anfrage steht in Was hat meine Anfrage gekostet?
Wenn etwas nicht klappt
400 unsupported_for_modelbeiweb_search: Das Modell hat keine eigene Suche, oder es sucht immer und du hastfalsegeschickt. Prüfeweb_searchundweb_search_forcedin der Modellliste.400beisearch_domain_filter: Prüfe, ob du Freigaben und Ausschlüsse gemischt,https://oder einen Pfad angegeben oder zu viele Domains geschickt hast.- Keine
citationsin der Antwort: Das Modell hat entschieden, dass es für diese Frage nicht suchen muss. Formuliere die Frage konkreter oder begrenze die Domains.