Przejdź do głównej treści
Dwie ścieżki do web search przez OrcaRouter:
  1. Modele search-preview — wywołaj wariant z wyszukiwaniem bezpośrednio przez /v1/chat/completions
  2. Tools / options na zwykłym modelu — przekaż web_search_options (Chat) lub tools: [{"type": "web_search"}] (Responses)

​
Modele search-preview (OpenAI)

OpenAI publikuje warianty search-preview dla kilku modeli — na przykład openai/gpt-4o-search-preview i openai/gpt-5-search-api. Wybierz jeden z nich jako model w /v1/chat/completions, a upstream obsługuje wyszukiwanie po stronie serwera. Wywołaj /v1/models, aby zobaczyć aktualny katalog.

​
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. Kontroluje głębokość wyszukiwania (cena per-wywołanie dla web_search jest taka sama niezależnie od rozmiaru).

​
Tools (Responses API)

/v1/responses akceptuje tools: [{"type": "web_search"}] zarówno na modelach OpenAI, jak i dowolnym modelu Grok — powierzchnia Agent Tools od xAI mieszka pod tym samym endpointem. 
# 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"}]
  }'
Każde web_search_call, które emituje upstream, jest liczone do rozliczeń — zobacz Operacje / Rozliczenia i zużycie.

​
Wsparcie między dostawcami

Web search sięga każdego dostawcy, który go udostępnia; różni się tylko punkt wejścia:
DostawcaWeb searchJak
OpenAI✅Modele search-preview lub przekaż narzędzie web_search do /v1/responses
xAI Grok✅Wywołaj /v1/responses z tools: [{"type": "web_search"}] i dowolnym modelem Grok — API Agent Tools od xAI. (xAI wycofał starsze search_parameters na chat completions w dniu 2026-01-12; stare warianty nazw *-search już nie działają.)
Anthropic✅Przekaż web_search_options w żądaniu Chat Completions — tłumaczone na natywne server-tool web_search Anthropic. search_context_size (low/medium/high) mapuje się na max_uses; user_location.approximate mapuje się na user_location Anthropic.
Gemini✅Przekaż narzędzie funkcyjne o nazwie googleSearch (zobacz poniżej) — tłumaczone na natywne narzędzie grounding GoogleSearch Gemini.
DeepSeek❌API DeepSeek nie udostępnia web search.

​
Gemini grounding przez googleSearch

Dla modeli Gemini warstwa tłumacząca OrcaRouter rozpoznaje magiczną nazwę funkcji googleSearch i zamienia ją w natywne narzędzie grounding GoogleSearch Gemini. Wyślij ją jak każde inne narzędzie funkcyjne w stylu 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"}}]
  }'
Metadane grounding zwrócone przez Gemini (webSearchQueries itd.) są rejestrowane przez bramę do rozliczeń i wystawiane przez standardowe pola chat-completion. Dwie powiązane magiczne nazwy funkcji są rozpoznawane na tej samej ścieżce kodu:
  • codeExecution — włącza natywne narzędzie wykonywania kodu Gemini
  • urlContext — włącza narzędzie URL-context Gemini

​
Lub natywnie

Jeśli już używasz natywnego protokołu Gemini przez /v1beta/, przekaż googleSearch bezpośrednio w kształcie Gemini — bez tłumaczenia magicznej nazwy: 
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": {}} i {"urlContext": {}} działają tak samo na ścieżce natywnej. Zobacz Formaty natywne / Gemini.

​
Rozliczenia

web_search i web_search_preview są śledzone jako wbudowane wywołania narzędzi. Mają różne progi cenowe — zobacz Operacje / Rozliczenia i zużycie, aby poznać szczegóły.