Веб-поиск (web-search)готовится

Веб-поиск — это инструмент модели. Вы разрешаете его в запросе, и модель сама решает, нужно ли искать. Если нужно — она формулирует поисковый запрос, забирает содержимое открытых веб-страниц и подставляет найденный текст в свой ответ.

Поиск идёт только по общедоступным страницам. Закрытые разделы, страницы за авторизацией и ваши внутренние документы через этот инструмент недоступны — для своих файлов планируется отдельный инструмент поиска по коллекциям.

За один запрос модель может выполнить несколько поисковых вызовов: например, уточнить формулировку или проверить факт по второму источнику. Каждый такой вызов оплачивается отдельно.

Инструмент передаётся в поле tools, как и любой другой инструмент в формате Chat Completions. Планируемый вид запроса:

curl https://api.librachat.kz/v1/chat/completions \
  -H "Authorization: Bearer sk-libra-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "libra-pro",
    "messages": [
      {"role": "user", "content": "Что нового в правилах маркировки рекламы в 2026 году?"}
    ],
    "tools": [
      {
        "type": "web_search",
        "web_search": {
          "max_uses": 3,
          "allowed_domains": [],
          "blocked_domains": []
        }
      }
    ],
    "tool_choice": "auto"
  }'

• type: "web_search" — включает инструмент. Без него поиск не выполняется.
• max_uses — потолок числа поисковых вызовов в одном запросе. Планируемое значение по умолчанию 3, потолок 10. Это ваш прямой рычаг контроля расходов.
• allowed_domains / blocked_domains — белый и чёрный список доменов. Пустые списки означают «искать без ограничений». Одновременно оба списка задавать нельзя.
• tool_choice: "auto" — модель решает сама. Значение "none" отключает поиск на конкретный запрос, не меняя тело tools.
• Планируется поддержка обоих режимов: обычного ответа и stream: true. При потоковой передаче события поиска приходят до основного текста.

Ответ остаётся стандартным объектом chat.completion. Инструмент добавляет к сообщению массив citations — что именно модель прочитала, и usage.web_search — сколько вызовов поиска было выполнено.

{
  "id": "chatcmpl-9f2a1c7b",
  "object": "chat.completion",
  "model": "libra-pro",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "С 1 марта 2026 года ... [1]. Штрафы за отсутствие токена выросли ... [2].",
        "citations": [
          {
            "index": 1,
            "url": "https://example-media.ru/news/marking-2026",
            "title": "Новые правила маркировки: что изменилось",
            "published_at": "2026-02-18",
            "quote": "Норма вступает в силу с 1 марта 2026 года."
          },
          {
            "index": 2,
            "url": "https://example-law.ru/articles/fines",
            "title": "Штрафы за нарушение маркировки",
            "published_at": "2026-03-04",
            "quote": "Размер штрафа для юридических лиц увеличен."
          }
        ]
      }
    }
  ],
  "usage": {
    "prompt_tokens": 11840,
    "completion_tokens": 612,
    "total_tokens": 12452,
    "web_search": {
      "calls": 2
    }
  }
}

Номера в квадратных скобках в тексте соответствуют полю index в citations. Если поиск не понадобился, массив citations отсутствует, а usage.web_search.calls равен нулю.

Счёт складывается из двух частей. Первая — сами поисковые вызовы, поштучно. Вторая — токены: текст найденных страниц модель дочитывает как входные токены, поэтому запрос с поиском почти всегда дороже по входу, чем такой же запрос без поиска. Оплачиваются все вызовы, даже если модель в итоге не сослалась на найденное.

Цены на веб-поиск и связанные с ним токены

Пример расчёта. Запрос к libra-pro с двумя поисковыми вызовами, 12 000 входных токенов (из них около 10 000 — текст найденных страниц) и 600 выходных: 2 × 1,35 = 2,70 ₽ за поиск, 12 000 × 450 / 1 000 000 = 5,40 ₽ за вход, 600 × 900 / 1 000 000 = 0,54 ₽ за выход. Итого около 8,64 ₽.

Практический совет: держите max_uses минимально достаточным. Разница между 3 и 10 вызовами — это не только 9,45 ₽ на тысячу запросов за сами вызовы, но и кратно больший объём входных токенов.