Документация API / Поиск в интернете

Сама модель в интернет не ходит: её знания заканчиваются на дате обучения. Чтобы она отвечала по свежим данным, добавьте в запрос к POST /chat/completions инструмент openrouter:web_search. Поиск выполняется на стороне сервера: модель сама решает, нужно ли искать, получает найденные страницы и пишет ответ со ссылками. Ваш код ничего дополнительно не вызывает.

Работает с любой моделью из каталога, у которой в поддерживаемых параметрах есть tools. У моделей Perplexity поиск встроен — им инструмент не нужен.

curl https://api.aiadapter.ru/api/v1/chat/completions \
  -H "Authorization: Bearer sk-aa-v1-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-opus-4.8",
    "messages": [{"role": "user", "content": "Какой сегодня курс доллара ЦБ РФ?"}],
    "tools": [{"type": "openrouter:web_search", "parameters": {"max_results": 5}}],
    "usage": {"include": true}
  }'

{
  "id": "gen-abc123",
  "model": "anthropic/claude-opus-4.8",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Официальный курс доллара на сегодня — 83,25 ₽. Источник: [Банк России](https://www.cbr.ru/currency_base/daily/)",
        "annotations": [
          {
            "type": "url_citation",
            "url_citation": {
              "url": "https://www.cbr.ru/currency_base/daily/",
              "title": "Официальные курсы валют | Банк России",
              "content": "…выдержка со страницы…"
            }
          }
        ]
      }
    }
  ],
  "usage": {
    "prompt_tokens": 2406,
    "completion_tokens": 72,
    "total_tokens": 2478,
    "cost_rub": 0.95,
    "server_tool_use_details": {
      "web_search_requests": 1
    }
  }
}

Параметры инструмента

Все необязательные, передаются в tools[].parameters.

параметр	значение
`engine`	Поисковый движок. По умолчанию `auto`: родной поиск провайдера модели, если он есть, иначе Exa. Можно задать явно: `native` или `exa`.
`max_results`	Сколько результатов возвращает один поиск. По умолчанию 5. Чем больше результатов, тем больше входных токенов.
`allowed_domains`	Массив доменов: искать только на них.
`excluded_domains`	Массив доменов: исключить их из поиска.

Источники в ответе

Найденные страницы приходят в choices[].message.annotations — объекты url_citation с адресом, заголовком и выдержкой. При стриминге они приходят в choices[].delta.annotations первыми чанками, до текста ответа. В самом тексте модель обычно ставит markdown-ссылки на источники.

Стоимость

Поиск оплачивается отдельно от токенов и входит в usage.cost_rub ответа. Число выполненных поисков — в usage.server_tool_use_details.web_search_requests.

Родной поиск провайдера — по цене из строки «Веб-поиск» на странице модели.
Поиск через Exa (модели без своего поиска) — 0.884 ₽ за запрос.
Найденные страницы попадают во входные токены и тарифицируются по цене модели.