Grounding with Google Search (заземление через Google Поиск) — это инструмент Gemini API, который позволяет моделям выполнять поиск в Google для получения актуальной информации из интернета перед генерацией ответа. Модель сама решает, когда выполнить поиск, и указывает использованные источники в метаданных ответа.
Когда вы добавляете инструмент google_search в свой запрос:
- Модель сама решает, нужен ли поиск, исходя из запроса. Для актуальных или фактологических вопросов она формирует один или несколько поисковых запросов.
- API выполняет поиск в Google и передаёт модели полученные результаты. В рамках одного запроса может быть выполнено несколько поисков.
- Модель формирует финальный ответ на основе результатов поиска и возвращает метаданные заземления (
groundingMetadata) с перечнем выполненных поисковых запросов и источников.
curl "https://api.proxyapi.ru/google/v1beta/models/gemini-2.5-flash:generateContent" \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer <КЛЮЧ>' \ -X POST \ -d '{ "contents": [{ "parts": [{"text": "Кто выиграл последнюю гонку Формулы-1?"}] }], "tools": [{"google_search": {}}] }'
Если модель выполнила поиск, в ответе появляется объект groundingMetadata внутри каждого кандидата. Он содержит:
webSearchQueries— список поисковых запросов, которые модель фактически выполнила.groundingChunks— источники (веб-страницы), использованные для ответа, с их заголовками и URL.groundingSupports— соответствие между фрагментами ответа и источниками, на основе которых они сформированы.searchEntryPoint— готовый HTML-блок с подсказками поиска (Search Suggestions). По требованиям Google его необходимо отображать пользователю вместе с ответом, если используется заземление.
Потребление токенов тарифицируется как обычно для выбранной модели. Дополнительно тарифицируется каждый поисковый запрос, который фактически выполнила модель: стоимость фиксированная и не зависит от количества потраченных токенов. Если модель не выполняла поиск, дополнительная плата не взимается. Цены здесь.
