Saltar al contenido principal
Dos caminos a la búsqueda web a través de OrcaRouter:
  1. Modelos search-preview — llama a una variante de búsqueda directamente vía /v1/chat/completions
  2. Herramientas / opciones en un modelo regular — pasa web_search_options (Chat) o tools: [{"type": "web_search"}] (Responses)

​
Modelos search-preview (OpenAI)

OpenAI publica variantes search-preview para varios modelos — por ejemplo openai/gpt-4o-search-preview y openai/gpt-5-search-api. Elige uno de estos como model en /v1/chat/completions y el upstream maneja la búsqueda del lado del servidor. Llama a /v1/models para el catálogo en vivo.

​
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 la profundidad de búsqueda (el precio por llamada para web_search es el mismo independientemente del tamaño).

​
Herramientas (API Responses)

/v1/responses acepta tools: [{"type": "web_search"}] en modelos OpenAI y cualquier modelo Grok — la superficie Agent Tools de xAI vive en el mismo 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 (Agent Tools de xAI)
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 emite el upstream se cuenta para facturación — consulta Operaciones / Facturación y uso.

​
Soporte entre proveedores

La búsqueda web alcanza a cada proveedor que la expone; solo el punto de entrada difiere:
ProveedorBúsqueda webCómo
OpenAI✅Modelos search-preview, o pasar herramienta web_search a /v1/responses
xAI Grok✅Llamar a /v1/responses con tools: [{"type": "web_search"}] y cualquier modelo Grok — la API Agent Tools de xAI. (xAI deprecó los antiguos search_parameters en chat completions el 2026-01-12; las antiguas variantes de nombre de modelo *-search ya no funcionan.)
Anthropic✅Pasa web_search_options en una solicitud Chat Completions — traducido a la herramienta de servidor nativa web_search de Anthropic. search_context_size (low/medium/high) mapea a max_uses; user_location.approximate mapea al user_location de Anthropic.
Gemini✅Pasa una herramienta de función llamada googleSearch (ver abajo) — traducida a la herramienta de anclaje nativa GoogleSearch de Gemini.
DeepSeek❌La API de DeepSeek no expone búsqueda web.

​
Anclaje de Gemini vía googleSearch

Para modelos Gemini, la capa de traducción de OrcaRouter reconoce un nombre de función mágico googleSearch y lo convierte en la herramienta de anclaje nativa GoogleSearch de Gemini. Envíalo como cualquier otra herramienta de función al 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"}}]
  }'
Los metadatos de anclaje que devuelve Gemini (webSearchQueries, etc.) son capturados por la pasarela para facturación y expuestos mediante los campos estándar de chat-completion. Dos nombres mágicos relacionados se reconocen en el mismo camino de código:
  • codeExecution — habilita la herramienta nativa de ejecución de código de Gemini
  • urlContext — habilita la herramienta URL-context de Gemini

​
O ve a nativo

Si ya estás en el protocolo nativo de Gemini vía /v1beta/, pasa googleSearch directamente en forma Gemini — sin traducción de nombre mágico necesaria: 
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": {}} y {"urlContext": {}} funcionan igual en el camino nativo. Consulta Formatos nativos / Gemini.

​
Facturación

web_search y web_search_preview se rastrean como llamadas a herramientas integradas. Tienen niveles de precio diferentes — consulta Operaciones / Facturación y uso para el desglose.