# Gemini 3.1 Pro Preview Custom Tools

> Модель для сложных задач с текстом, изображениями и другими входными данными; в сценариях с инструментами ориентируется на вызов подходящих пользовательских функций.

- **ID для API:** `google/gemini-3.1-pro-preview-customtools`
- **Тип Модели:** Чат-модель
- **Контекст:** 1 048 576 токенов
- **Максимум на ответ:** 65 536 токенов
- **Вход:** текст, аудио, изображение, видео, файл → **Выход:** текст

## Описание

#### Суть
Это вариант Gemini 3.1 Pro Preview, предназначенный для работы с пользовательскими инструментами. Его особенность — более точный выбор инструментов: модель должна реже прибегать к универсальному bash-инструменту, когда задачу эффективнее решить через подключённую стороннюю функцию. Это полезно в агентных приложениях, где вызов API, поиск по данным или другое действие выполняется через набор заранее объявленных инструментов. Gemini 3.1 Pro Google позиционирует как модель для сложных задач, требующих рассуждений и синтеза информации; вариант Custom Tools сохраняет эту основу и делает акцент на выборе инструментов.

#### Сильные стороны
Модель подходит для многошаговых запросов, в которых нужно не только сформулировать ответ, но и определить, какое действие следует передать внешней функции. Пользовательские инструменты могут связывать ассистента с API, данными или операциями приложения. Как и в стандартном сценарии function calling Gemini, приложение объявляет доступные функции, выполняет вызовы и передаёт модели результаты для продолжения работы. Это позволяет встроить модель в агентный процесс с контролируемым набором действий.

#### Контекст и модальности
По данным каталога, размер контекстного окна — 1 048 576 токенов, максимальный объём ответа — 65 536 токенов. На вход принимает текст, аудио, изображения, видео и файлы; генерирует текст. Поддержка модальностей сама по себе не означает, что каждый тип входа доступен в любом API или режиме использования.

#### Типовые сценарии
Вариант может быть полезен для ассистентов, которым необходимо выбирать между несколькими собственными функциями, систем для автоматизации рабочих процессов и приложений, где нежелательно заменять специализированные интеграции выполнением команд через общий bash-инструмент. Также он подходит для анализа больших объёмов смешанных входных данных с последующим текстовым ответом.

#### Ограничения
Это preview-версия, а не указание на окончательные характеристики. Пользовательские функции не исполняются моделью самостоятельно: приложение интегратора отвечает за выполнение вызова и передачу результата обратно. Поэтому корректность и безопасность действий зависят также от реализации инструментов и контроля доступа. Доступность конкретных инструментов определяется настройкой API и приложения.

#### Отличие от соседей по семейству
В сравнении с обычным Gemini 3.1 Pro Preview ключевое заявленное отличие — настройка поведения при выборе инструментов, а не отдельная модальность или новая задача общего назначения. Для приложений без пользовательских инструментов это отличие может быть несущественным; в агентных сценариях, где важен приоритет специализированных функций над универсальным bash, оно становится основным.

## Цены

- Запрос / 1М: 241,76 ₽
- Ответ / 1М: 1 450,54 ₽
- Изображение вход / 1М: 241,76 ₽
- Чтение кэша / 1М: 24,18 ₽
- Запись кэша / 1М: 45,33 ₽
- Веб-поиск / 1000 запросов: 1 692,29 ₽

## Параметры

reasoning, include_reasoning, max_tokens, temperature, top_p, seed, response_format, tools, tool_choice, structured_outputs, reasoning_effort

## Провайдеры

Выбрать Провайдера можно параметром `provider` в запросе.

| Провайдер | Цена | Контекст | Макс. ответ | Данные в РФ | 152-ФЗ |
| --- | --- | --- | --- | --- | --- |
| google-ai-studio | Запрос / 1М: 241,76 ₽; Ответ / 1М: 1 450,54 ₽; Изображение вход / 1М: 241,76 ₽ | 1 048 576 | 65 536 | — | — |

## Быстрый старт

```bash
curl https://polza.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $POLZA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "google/gemini-3.1-pro-preview-customtools",
  "messages": [
    {
      "role": "user",
      "content": "Привет"
    }
  ]
}'
```

## Ссылки

- Страница: https://polza.ai/models/google/gemini-3.1-pro-preview-customtools
- Каталог: https://polza.ai/models