Перейти к основному содержанию
Два пути к веб-поиску через OrcaRouter:
  1. Search-preview модели — вызывайте поисковый вариант напрямую через /v1/chat/completions
  2. Инструменты / опции на обычной модели — передавайте web_search_options (Chat) или tools: [{"type": "web_search"}] (Responses)

​
Search-preview модели (OpenAI)

OpenAI публикует search-preview варианты для нескольких моделей — например, openai/gpt-4o-search-preview и openai/gpt-5-search-api. Выберите одну из них как model на /v1/chat/completions, и upstream сам обработает поиск на стороне сервера. Вызовите /v1/models для актуального каталога.

​
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. Управляет глубиной поиска (цена за вызов web_search одинакова независимо от размера).

​
Инструменты (Responses API)

/v1/responses принимает tools: [{"type": "web_search"}] как на моделях OpenAI, так и на любой модели Grok — Agent Tools от xAI живёт на том же эндпоинте. 
# 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"}]
  }'
Каждый web_search_call, испускаемый upstream, учитывается для биллинга — см. Operations / Биллинг и использование.

​
Поддержка у разных провайдеров

Веб-поиск доступен у каждого провайдера, который его предоставляет; различается только точка входа:
ПровайдерВеб-поискКак
OpenAI✅Search-preview модели или передача инструмента web_search в /v1/responses
xAI Grok✅Вызов /v1/responses с tools: [{"type": "web_search"}] и любой моделью Grok — Agent Tools API от xAI. (xAI прекратил поддержку устаревших search_parameters в chat completions с 2026-01-12; старые варианты имени модели *-search больше не работают.)
Anthropic✅Передача web_search_options в запросе Chat Completions — транслируется в нативный server-tool Anthropic web_search. search_context_size (low/medium/high) сопоставляется с max_uses; user_location.approximate сопоставляется с user_location у Anthropic.
Gemini✅Передача функционального инструмента с именем googleSearch (см. ниже) — транслируется в нативный grounding-инструмент Gemini GoogleSearch.
DeepSeek❌DeepSeek API не предоставляет веб-поиск.

​
Grounding Gemini через googleSearch

Для моделей Gemini слой трансляции OrcaRouter распознаёт магическое имя функции googleSearch и превращает его в нативный grounding-инструмент Gemini GoogleSearch. Отправляйте его как любой другой функциональный инструмент в стиле 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"}}]
  }'
Метаданные grounding, которые возвращает Gemini (webSearchQueries и т. д.), фиксируются шлюзом для биллинга и пробрасываются через стандартные поля chat-completion. Ещё два связанных магических имени функций распознаются на том же пути:
  • codeExecution — включает нативный инструмент выполнения кода Gemini
  • urlContext — включает инструмент URL-контекста Gemini

​
Или используйте нативный путь

Если вы уже на нативном протоколе Gemini через /v1beta/, передавайте googleSearch напрямую в формате Gemini — никакой трансляции магических имён не требуется: 
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": {}} и {"urlContext": {}} работают так же на нативном пути. См. Нативные форматы / Gemini.

​
Биллинг

web_search и web_search_preview учитываются как вызовы встроенных инструментов. У них разные ценовые уровни — разбивку см. в Operations / Биллинг и использование.