Saltar para o conteúdo principal
Dois caminhos para busca web pelo OrcaRouter:
  1. Modelos search-preview — chame uma variante de busca diretamente via /v1/chat/completions
  2. Ferramentas / opções em um modelo regular — passe web_search_options (Chat) ou tools: [{"type": "web_search"}] (Responses)

​
Modelos search-preview (OpenAI)

A OpenAI publica variantes search-preview para vários modelos — por exemplo openai/gpt-4o-search-preview e openai/gpt-5-search-api. Escolha um destes como model em /v1/chat/completions e o upstream lida com a busca no lado do servidor. Chame /v1/models para o catálogo ativo.

​
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. Controla a profundidade da busca (o preço por chamada de web_search é o mesmo independente do tamanho).

​
Ferramentas (Responses API)

/v1/responses aceita tools: [{"type": "web_search"}] tanto em modelos OpenAI quanto em qualquer modelo Grok — a superfície Agent Tools da xAI vive no mesmo 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"}]
  }'
Cada web_search_call que o upstream emite é contabilizado para faturamento — veja Operações / Faturamento e uso.

​
Suporte entre provedores

A busca web atinge todos os provedores que a expõem; apenas o ponto de entrada difere:
ProvedorBusca webComo
OpenAI✅Modelos search-preview, ou passe a ferramenta web_search para /v1/responses
xAI Grok✅Chame /v1/responses com tools: [{"type": "web_search"}] e qualquer modelo Grok — Agent Tools API da xAI. (A xAI descontinuou o legado search_parameters em chat completions em 2026-01-12; as antigas variantes *-search no nome do modelo não funcionam mais.)
Anthropic✅Passe web_search_options em uma requisição Chat Completions — traduzido para a ferramenta de servidor nativa web_search da Anthropic. search_context_size (low/medium/high) mapeia para max_uses; user_location.approximate mapeia para user_location da Anthropic.
Gemini✅Passe uma ferramenta de função chamada googleSearch (veja abaixo) — traduzida para a ferramenta de grounding nativa GoogleSearch do Gemini.
DeepSeek❌A API DeepSeek não expõe busca web.

​
Grounding do Gemini via googleSearch

Para modelos Gemini, a camada de tradução do OrcaRouter reconhece um nome mágico de função googleSearch e o transforma na ferramenta de grounding nativa GoogleSearch do Gemini. Envie-o como qualquer outra ferramenta de função no estilo 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"}}]
  }'
Os metadados de grounding que o Gemini retorna (webSearchQueries, etc.) são capturados pelo gateway para faturamento e expostos por meio dos campos padrão de chat completion. Dois nomes de função mágicos relacionados são reconhecidos no mesmo caminho de código:
  • codeExecution — habilita a ferramenta nativa de execução de código do Gemini
  • urlContext — habilita a ferramenta URL-context do Gemini

​
Ou use nativo

Se você já está no protocolo nativo do Gemini via /v1beta/, passe googleSearch diretamente no formato Gemini — nenhuma tradução de nome mágico necessária: 
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": {}} funcionam da mesma forma no caminho nativo. Veja Formatos nativos / Gemini.

​
Faturamento

web_search e web_search_preview são rastreados como chamadas de ferramentas integradas. Eles têm níveis de preço diferentes — veja Operações / Faturamento e uso para o detalhamento.