Zum Hauptinhalt springen
Zwei Pfade zur Websuche über OrcaRouter:
  1. Search-preview-Modelle — rufe eine Suchvariante direkt über /v1/chat/completions auf
  2. Tools / Optionen auf einem normalen Modell — übergib web_search_options (Chat) oder tools: [{"type": "web_search"}] (Responses)

​
Search-preview-Modelle (OpenAI)

OpenAI veröffentlicht search-preview-Varianten für mehrere Modelle — zum Beispiel openai/gpt-4o-search-preview und openai/gpt-5-search-api. Wähle eines davon als model auf /v1/chat/completions und der Upstream erledigt die Suche serverseitig. Rufe /v1/models für den Live-Katalog auf.

​
web_search_options (Chat Completions)

curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "openai/gpt-4o-search-preview",
    "messages": [{"role": "user", "content": "What changed in OpenAI pricing this week?"}],
    "web_search_options": {"search_context_size": "medium"}
  }'
search_context_size: low / medium / high. Steuert die Suchtiefe (der Preis pro Aufruf für web_search ist unabhängig von der Größe derselbe).

​
Tools (Responses-API)

/v1/responses akzeptiert tools: [{"type": "web_search"}] auf OpenAI-Modellen und jedem Grok-Modell — die Agent-Tools-Oberfläche von xAI lebt auf demselben Endpunkt. 
# OpenAI
curl https://api.orcarouter.ai/v1/responses \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "openai/gpt-5",
    "input": "What changed in OpenAI pricing this week?",
    "tools": [{"type": "web_search"}]
  }'

# Grok (xAI Agent Tools)
curl https://api.orcarouter.ai/v1/responses \
  -H "Authorization: Bearer sk-orca-..." \
  -d '{
    "model": "grok/grok-4-fast-reasoning",
    "input": "What changed in xAI pricing this week?",
    "tools": [{"type": "web_search"}]
  }'
Jeder web_search_call, den der Upstream emittiert, wird für die Abrechnung gezählt — siehe Betrieb / Abrechnung & Nutzung.

​
Anbieterübergreifende Unterstützung

Websuche erreicht jeden Anbieter, der sie freigibt; nur der Einstiegspunkt unterscheidet sich:
AnbieterWebsucheWie
OpenAI✅Search-preview-Modelle, oder web_search-Tool an /v1/responses übergeben
xAI Grok✅/v1/responses mit tools: [{"type": "web_search"}] und beliebigem Grok-Modell aufrufen — Agent-Tools-API von xAI. (xAI hat die alten search_parameters auf Chat Completions am 2026-01-12 abgekündigt; die alten *-search-Modellnamenvarianten funktionieren nicht mehr.)
Anthropic✅Übergib web_search_options an eine Chat-Completions-Anfrage — übersetzt in das native web_search-Servertool von Anthropic. search_context_size (low/medium/high) wird auf max_uses abgebildet; user_location.approximate wird auf Anthropics user_location abgebildet.
Gemini✅Übergib ein Funktionstool namens googleSearch (siehe unten) — übersetzt in das native GoogleSearch-Grounding-Tool von Gemini.
DeepSeek❌Die DeepSeek-API stellt keine Websuche bereit.

​
Gemini-Grounding über googleSearch

Für Gemini-Modelle erkennt die Übersetzungsschicht von OrcaRouter einen magischen Funktionsnamen googleSearch und verwandelt ihn in das native GoogleSearch-Grounding-Tool von Gemini. Sende ihn wie jedes andere Funktionstool im OpenAI-Stil: 
curl https://api.orcarouter.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "google/gemini-2.5-flash",
    "messages": [{"role":"user","content":"What changed in Gemini pricing this week?"}],
    "tools": [{"type":"function","function":{"name":"googleSearch"}}]
  }'
Die Grounding-Metadaten, die Gemini zurückgibt (webSearchQueries, usw.), werden vom Gateway für die Abrechnung erfasst und über Standard-Chat-Completion-Felder bereitgestellt. Zwei verwandte magische Funktionsnamen werden auf demselben Codepfad erkannt:
  • codeExecution — aktiviert das native Code-Execution-Tool von Gemini
  • urlContext — aktiviert das URL-Kontext-Tool von Gemini

​
Oder geh nativ

Wenn du bereits auf dem nativen Protokoll von Gemini über /v1beta/ bist, übergib googleSearch direkt in Gemini-Form — keine magische-Name-Übersetzung erforderlich: 
curl "https://api.orcarouter.ai/v1beta/models/google/gemini-2.5-flash:generateContent" \
  -H "Authorization: Bearer sk-orca-..." \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role":"user","parts":[{"text":"What changed in Gemini pricing this week?"}]}],
    "tools": [{"googleSearch": {}}]
  }'
{"codeExecution": {}} und {"urlContext": {}} funktionieren auf dem nativen Pfad gleich. Siehe Native Formate / Gemini.

​
Abrechnung

web_search und web_search_preview werden als eingebaute Tool-Aufrufe nachverfolgt. Sie haben unterschiedliche Preisstufen — siehe Betrieb / Abrechnung & Nutzung für die Aufschlüsselung.