Tools API
Поисковые и исследовательские API рядом с моделями
Tools API — публичные маршруты /v1/tools/* для задач, где модели нужен внешний контекст: найти свежие страницы, извлечь текст с сайта, построить карту разделов или запустить более длинное исследование.
Это не tool calling внутри Chat Completions. Приложение вызывает Tools API напрямую, получает структурированные данные, а затем при необходимости передаёт их в модель через обычные маршруты /v1/chat/completions, /v1/responses или другой подходящий API.
Что доступно
Gateway предоставляет две группы инструментов:
- Tavily — поиск, извлечение страниц, обход сайта, карта сайта и асинхронное исследование.
- SerpApi — Google Search, AI Mode, Images и News.
Оба варианта используют тот же публичный базовый адрес, что и модельные маршруты:
Base URL: {{PUBLIC_API_BASE_URL}}
Authorization: Bearer gw_live_...Когда использовать
Tools API полезен, если приложению нужно:
- найти свежие источники перед генерацией ответа;
- собрать страницы для RAG-пайплайна;
- извлечь текст со страницы без отдельного парсера;
- проверить, какие URL доступны на сайте;
- получить поисковую выдачу и уже потом попросить модель подготовить вывод.
Типичный поток:
- Приложение вызывает поиск или извлечение через
/v1/tools/*. - Сервер получает результаты и выбирает полезные фрагменты.
- Эти фрагменты передаются в модель как контекст.
- Модель отвечает пользователю с учётом найденных данных.
Доступ и оплата
Tools API использует те же ключи API, рабочие пространства, подписку, расписание ключа и лимиты скорости, что и запросы к моделям.
По умолчанию Tools API доступен на Pro. Для Enterprise доступ и лимиты настраиваются индивидуально. Расход инструментов учитывается в общем бюджете подписки вместе с модельными запросами.
Клиент не передаёт ключи поставщиков инструментов. Не добавляйте в запросы поля вроде api_key: Gateway использует серверные ключи и не возвращает их в ответах.
В Дашборде можно выключить Tools API для конкретного ключа. Это не отзывает ключ и не запрещает модельные маршруты, но блокирует /v1/tools/* для этого ключа.
Логи и использование для Tools API показываются отдельно от модельных запросов. В customer-facing данных нет сырых payload, provider request id, стоимости, units, ключей поставщиков и внутренних идентификаторов.
Что читать дальше
- «Справочник API» → «Tools API» — список маршрутов и параметры запросов.
- «Оплата и тарифы» — как тариф влияет на доступ к инструментам.
- «Логи» и «Использование» в Дашборде — как смотреть расход и ошибки.