Для получения чистого Markdown любой страницы добавьте .md к URL страницы.
Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.
Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.
Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к серверу MCP по адресу https://api.vega.chat/docs/_mcp/server.

Для получения более качественных результатов попробуйте инструмент сервера openrouter:web_search. Инструменты сервера дают модели контроль над тем, когда и как часто выполнять поиск, вместо того чтобы запускать его каждый запрос.

Вы можете включить релевантные результаты веб‑поиска для любой модели в VEGA, активировав и настроив плагин web, либо добавив :online к идентификатору модели:

{
  "model": "openai/gpt-5.2:online"
}

Вы также можете добавить :online к вариантам моделей :free следующим образом:

{
  "model": "openai/gpt-oss-20b:free:online"
}

Использование веб‑поиска приведёт к дополнительным расходам, даже с бесплатными моделями. Подробнее см. раздел ценообразования ниже.

:online — это сокращение для использования плагина web и полностью эквивалентно:

{
  "model": "openrouter/auto",
  "plugins": [{ "id": "web" }]
}

Плагин веб‑поиска использует нативный поиск для моделей Anthropic, OpenAI, Perplexity и xAI.

Для моделей xAI плагин веб‑поиска включает как Web Search, так и X Search.

Для остальных моделей плагин веб‑поиска использует Exa. Он применяет их метод "auto" (комбинацию ключевого поиска и поиска на основе эмбеддингов), чтобы находить наиболее релевантные результаты и обогащать/обосновывать ваш запрос. Для каждого результата VEGA запрашивает у Exa выдержки — извлечённые фрагменты страницы, которые Exa считает наиболее релевантными запросу, размер которых адаптируется (обычно ~2 000–4 000 символов на результат). Они возвращаются модели и отображаются через аннотации url_citation, при этом маркеры Exa [...] разделяют выдержки, полученные из разных частей одной страницы.

Разбор результатов веб‑поиска

Результаты веб‑поиска для всех моделей (включая модели только с нативным поиском, такие как Perplexity и OpenAI Online) доступны через API и стандартизированы VEGA, чтобы соответствовать единой схеме аннотаций в типе сообщения Chat Completion от OpenAI:

{
  "message": {
    "role": "assistant",
    "content": "Here's the latest news I found: ...",
    "annotations": [
      {
        "type": "url_citation",
        "url_citation": {
          "url": "https://www.example.com/web-search-result",
          "title": "Title of the web search result",
          "content": "Content of the web search result", // Added by VEGA if available
          "start_index": 100, // The index of the first character of the URL citation in the message.
          "end_index": 200 // The index of the last character of the URL citation in the message.
        }
      }
    ]
  }
}

Настройка веб‑плагина

Максимальное количество результатов, разрешённое плагином web, а также подсказка, используемая для их добавления в поток сообщений, могут быть настроены:

{
  "model": "openai/gpt-5.2:online",
  "plugins": [
    {
      "id": "web",
      "engine": "exa", // Optional: "native", "exa", "firecrawl", "parallel", or undefined
      "max_results": 1, // Defaults to 5
      "search_prompt": "Some relevant web results:", // See default below
      "include_domains": ["example.com", "*.substack.com"], // Optional
      "exclude_domains": ["reddit.com"] // Optional
    }
  ]
}

По умолчанию плагин web использует следующую подсказку поиска, используя текущую дату:

Фильтрация доменов

Вы можете ограничить, какие домены появляются в результатах веб‑поиска, используя include_domains и exclude_domains:

{
  "model": "openai/gpt-5.2",
  "plugins": [
    {
      "id": "web",
      "include_domains": ["example.com", "*.substack.com"],
      "exclude_domains": ["reddit.com"]
    }
  ]
}

Оба поля принимают массив строк доменов. Вы можете использовать подстановочные знаки (*.substack.com) и фильтрацию по пути (openai.com/blog).

Совместимость движков

Поведение нативных провайдеров

При использовании нативного поиска поддержка фильтрации доменов зависит от провайдера:

• Anthropic: Поддерживает как include_domains, так и exclude_domains, но они взаимно исключают друг друга — нельзя использовать оба одновременно
• OpenAI: Поддерживает только include_domains; exclude_domains игнорируется без предупреждения
• xAI: Поддерживает оба, но они взаимно исключают друг друга, максимум 5 доменов для каждого

Фильтры X Search (только xAI)

При использовании моделей xAI с включённым веб‑поиском VEGA автоматически добавляет инструмент x_search рядом с web_search. Вы можете передать параметры фильтра, чтобы управлять результатами поиска X/Twitter, используя параметр верхнего уровня x_search_filter:

{
  "model": "x-ai/grok-4.1-fast",
  "messages": [
    {
      "role": "user",
      "content": "What are people saying about VEGA?"
    }
  ],
  "plugins": [{ "id": "web" }],
  "x_search_filter": {
    "allowed_x_handles": ["OpenRouterAI"],
    "from_date": "2025-01-01",
    "to_date": "2025-12-31"
  }
}

Параметры фильтра

allowed_x_handles и excluded_x_handles взаимно исключают друг друга — нельзя использовать оба в одном запросе. Если проверка не проходит, фильтр тихо отбрасывается и вместо него используется базовый инструмент x_search.

Выбор движка

Плагин веб‑поиска поддерживает следующие варианты параметра engine:

• native: Всегда использует встроенные возможности веб‑поиска провайдера модели
• exa: Использует API поиска Exa для веб‑результатов
• firecrawl: Использует API поиска Firecrawl
• parallel: Использует API поиска Parallel для веб‑результатов
• undefined (не указано): Использует нативный поиск, если он доступен у провайдера, иначе переходит к Exa

Поведение по умолчанию

Когда параметр engine не указан:

• Нативный поиск используется по умолчанию для моделей OpenAI, Anthropic, Perplexity и xAI, которые его поддерживают
• Поиск Exa используется для всех остальных моделей или когда нативный поиск не поддерживается

Если явно указать "engine": "native", будет всегда попытка использовать нативный поиск провайдера, даже если модель его не поддерживает (что может привести к ошибке).

Принудительный выбор движка

Вы можете явно указать, какой движок использовать:

{
  "model": "openai/gpt-5.2",
  "plugins": [
    {
      "id": "web",
      "engine": "native"
    }
  ]
}

Или принудительно использовать поиск Exa даже для моделей, поддерживающих нативный поиск:

{
  "model": "openai/gpt-5.2",
  "plugins": [
    {
      "id": "web",
      "engine": "exa",
      "max_results": 3
    }
  ]
}

Firecrawl

Firecrawl — это поисковый движок BYOK (bring your own key). Чтобы использовать его:

1. Перейдите в настройки плагинов VEGA и выберите Firecrawl в качестве движка веб‑поиска
2. Примите Условия обслуживания Firecrawl — это автоматически создаст аккаунт Firecrawl, связанный с вашей электронной почтой
3. Ваш аккаунт начинается с 10 000 бесплатных кредитов (кредиты истекают через 3 месяца)

После настройки поисковые запросы Firecrawl используют ваши кредиты Firecrawl напрямую — дополнительных расходов от VEGA нет.

{
  "model": "openai/gpt-5.2",
  "plugins": [
    {
      "id": "web",
      "engine": "firecrawl",
      "max_results": 5
    }
  ]
}

Firecrawl поддерживает include_domains и exclude_domains, но они взаимно исключают друг друга — нельзя использовать оба в одном запросе.

Parallel

Parallel — поисковый движок, поддерживающий фильтрацию доменов и использующий кредиты VEGA по цене 0.5 ₽ за запрос. Включает до 10 результатов в запросе, затем 0.1 ₽ за каждый дополнительный результат.

{
  "model": "openai/gpt-5.2",
  "plugins": [
    {
      "id": "web",
      "engine": "parallel",
      "max_results": 5,
      "include_domains": ["arxiv.org"]
    }
  ]
}

Ценообразование в зависимости от движка

• Нативный поиск: Ценообразование передаётся напрямую от провайдера (см. информацию о ценах провайдера ниже)
• Поиск Exa: Использует кредиты VEGA по цене 0.5 ₽ за запрос. Включает до 10 результатов, затем 0.1 ₽ за каждый дополнительный результат
• Поиск Parallel: Использует кредиты VEGA по цене 0.5 ₽ за запрос. Включает до 10 результатов в запросе, затем 0.1 ₽ за каждый дополнительный результат
• Поиск Firecrawl: Использует ваши кредиты Firecrawl напрямую, пополнение доступно на Firecrawl.dev

Ценообразование

Ценообразование поиска Exa

При использовании поиска Exa (явно через "engine": "exa" или как резервный вариант) плагин web использует ваши кредиты VEGA и взимает 0.5 ₽ за запрос. Это включает до 10 результатов; дополнительные результаты оплачиваются по 0.1 ₽ каждый, плюс расход токенов LLM для подсказки с результатами поиска.

Ценообразование нативного поиска (передача от провайдера)

Некоторые модели имеют встроенный веб‑поиск. Эти модели взимают плату в зависимости от размера контекста поиска, который определяет, сколько данных поиска будет получено и обработано для запроса.

Пороговые значения размера контекста поиска

Контекст поиска может быть «low», «medium» или «high» и определяет, сколько контекста поиска будет получено для запроса:

• Low: Минимальный контекст поиска, подходит для простых запросов
• Medium: Умеренный контекст поиска, хорош для общих запросов
• High: Обширный контекст поиска, идеален для детального исследования

Указание размера контекста поиска

Вы можете указать размер контекста поиска в запросе API, используя параметр web_search_options:

{
  "model": "openai/gpt-4.1",
  "messages": [
    {
      "role": "user",
      "content": "What are the latest developments in quantum computing?"
    }
  ],
  "web_search_options": {
    "search_context_size": "high"
  }
}

Обратитесь к документации каждого провайдера для получения информации о ценах на их нативный веб‑поиск:

• Ценообразование OpenAI
• Ценообразование Anthropic
• Ценообразование Perplexity
• Ценообразование xAI

Ценообразование нативного веб‑поиска применяется только при использовании "engine": "native" или когда нативный поиск используется по умолчанию для поддерживаемых моделей. При использовании "engine": "exa" применяется ценообразование поиска Exa.