Справочник APITools API
Обзор Tools API
Общие правила маршрутов /v1/tools
Tools API — публичные маршруты для поиска, извлечения данных и исследовательских задач. Они помогают подготовить контекст для моделей, но вызываются отдельно от OpenAI-совместимых маршрутов генерации.
POST
/v1/tools/tavily/searchPOST
/v1/tools/tavily/extractPOST
/v1/tools/tavily/crawlPOST
/v1/tools/tavily/mapPOST
/v1/tools/tavily/researchGET
/v1/tools/tavily/research/{job_id}GET
/v1/tools/serpapi/searchОбщие правила
- Все маршруты требуют платформенный ключ
gw_live_*в заголовкеAuthorization. - Ключ должен быть активен, не просрочен и доступен по расписанию.
- У ключа должен быть включён доступ к Tools API.
- Организация должна иметь активную подписку и право на нужный инструмент.
- Расход инструментов учитывается вместе с расходом моделей.
- Не передавайте ключи поставщиков, служебные заголовки и внутренние параметры.
curl {{PUBLIC_API_BASE_URL}}/tools/serpapi/search?q=ai%20news \
-H "Authorization: Bearer gw_live_..."Ошибки
| Код | Что значит |
|---|---|
400 | Неверные параметры инструмента. |
401 | Ключ не передан или неверен. |
403 | Инструмент недоступен на тарифе, Tools API выключен для ключа, сам ключ выключен или сработало ограничение. |
404 | Задача не найдена или принадлежит другому ключу. |
429 | Слишком много запросов. |
503 | Инструмент или бюджет временно недоступен. |
Повторять стоит только временные ошибки: 429, 502, 503, 504.