FlowModels

Websuche einschalten, auf Domains begrenzen und Quellen auslesen

Veröffentlicht am 11. November 2026

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 mit 400 unsupported_for_model abgelehnt.

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 hat
  • search_results: je Quelle title, url und date
"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_model bei web_search: Das Modell hat keine eigene Suche, oder es sucht immer und du hast false geschickt. Prüfe web_search und web_search_forced in der Modellliste.
  • 400 bei search_domain_filter: Prüfe, ob du Freigaben und Ausschlüsse gemischt, https:// oder einen Pfad angegeben oder zu viele Domains geschickt hast.
  • Keine citations in der Antwort: Das Modell hat entschieden, dass es für diese Frage nicht suchen muss. Formuliere die Frage konkreter oder begrenze die Domains.

War dieser Artikel hilfreich?

Zurück zu Modelle, Limits & Fehler