Vai al contenuto principale
Due percorsi per la ricerca web tramite OrcaRouter:
  1. Modelli search-preview — chiama direttamente una variante di ricerca tramite /v1/chat/completions
  2. Strumenti / opzioni su un modello regolare — passa web_search_options (Chat) oppure tools: [{"type": "web_search"}] (Responses)

​
Modelli search-preview (OpenAI)

OpenAI pubblica varianti search-preview per diversi modelli — ad esempio openai/gpt-4o-search-preview e openai/gpt-5-search-api. Scegli una di queste come model su /v1/chat/completions e l’upstream gestisce la ricerca lato server. Chiama /v1/models per il catalogo aggiornato.

​
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. Controlla la profondità di ricerca (il prezzo per chiamata per web_search è lo stesso indipendentemente dalla dimensione).

​
Tools (Responses API)

/v1/responses accetta tools: [{"type": "web_search"}] sia sui modelli OpenAI sia su qualsiasi modello Grok — la superficie Agent Tools di xAI risiede allo stesso endpoint. 
# 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"}]
  }'
Ogni web_search_call emesso dall’upstream viene conteggiato per la fatturazione — vedi Operazioni / Fatturazione e utilizzo.

​
Supporto cross-provider

La ricerca web raggiunge ogni provider che la espone; differisce solo il punto di ingresso:
ProviderRicerca webCome
OpenAI✅Modelli search-preview, oppure passa lo strumento web_search a /v1/responses
xAI Grok✅Chiama /v1/responses con tools: [{"type": "web_search"}] e qualsiasi modello Grok — Agent Tools API di xAI. (xAI ha deprecato il vecchio search_parameters sulle chat completions il 2026-01-12; le vecchie varianti di nome modello *-search non funzionano più.)
Anthropic✅Passa web_search_options su una richiesta Chat Completions — tradotto nello strumento server web_search nativo di Anthropic. search_context_size (low/medium/high) mappa a max_uses; user_location.approximate mappa a user_location di Anthropic.
Gemini✅Passa uno strumento funzione chiamato googleSearch (vedi sotto) — tradotto nello strumento di grounding GoogleSearch nativo di Gemini.
DeepSeek❌L’API DeepSeek non espone la ricerca web.

​
Grounding Gemini tramite googleSearch

Per i modelli Gemini, il livello di traduzione di OrcaRouter riconosce un nome di funzione magico googleSearch e lo trasforma nello strumento di grounding GoogleSearch nativo di Gemini. Inviarlo come qualsiasi altro strumento funzione in stile OpenAI: 
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"}}]
  }'
I metadati di grounding restituiti da Gemini (webSearchQueries, ecc.) sono catturati dal gateway per la fatturazione e affiorano attraverso campi chat-completion standard. Due nomi di funzione magici correlati sono riconosciuti sullo stesso percorso di codice:
  • codeExecution — abilita lo strumento di esecuzione codice nativo di Gemini
  • urlContext — abilita lo strumento URL-context di Gemini

​
Oppure vai nativo

Se sei già sul protocollo nativo di Gemini tramite /v1beta/, passa googleSearch direttamente in forma Gemini — nessuna traduzione di nome magico necessaria: 
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": {}} e {"urlContext": {}} funzionano allo stesso modo sul percorso nativo. Vedi Formati nativi / Gemini.

​
Fatturazione

web_search e web_search_preview sono tracciati come chiamate a strumenti integrati. Hanno fasce di prezzo diverse — vedi Operazioni / Fatturazione e utilizzo per i dettagli.