Gemini 3.1 Pro Preview и Customtools: отличия моделей

Оба имени Gemini 3.1 Pro — официальные ID моделей Google. gemini-3.1-pro-preview — обычная модель. gemini-3.1-pro-preview-customtools — вариант для более эффективного использования пользовательских инструментов, когда агенту также доступен bash. Суффикс не означает «больше рассуждений», а обычная модель уже поддерживает вызов функций.^[1]

Для обычных задач программирования, анализа документов и мультимодальных вопросов разумно начать с обычной Preview. Рассмотрите сравнение с Customtools, если агент постоянно выбирает команду оболочки вместо нужной пользовательской функции. Рекомендация следует из документированного различия; статья не представляет новый A/B-бенчмарк.

Два ID моделей Gemini 3.1 Pro

Копируйте в конфигурацию полный идентификатор. Оба ID содержат preview; Customtools — отдельный вариант внутри этого семейства релизов.

ID модели	Документированное назначение	Полезный вопрос для оценки
`gemini-3.1-pro-preview`	Универсальная модель с рассуждениями и вызовом функций	Точно ли она выполняет задачу с переданным контекстом?
`gemini-3.1-pro-preview-customtools`	Более высокий приоритет пользовательских инструментов, когда также доступен bash	Выбирает ли она нужный пользовательский инструмент и верно ли использует его результат?

Google перечисляет оба имени на странице модели. Там же есть предупреждение, что версия Customtools может показывать колебания качества на запросах, которым такой сценарий с инструментами не помогает. Другой суффикс — повод оценить конкретное поведение, а не доказательство улучшения во всём.^[1]

Общая спецификация модели указывает лимит ввода 1,048,576 токенов, лимит вывода 65,536 токенов, мультимодальный ввод и текстовый вывод. Эти основные пределы не говорят, какой инструмент агент выберет в конкретном диалоге. При сравнении результатов рассматривайте отдельно идентификатор модели, определения инструментов и результат задачи.

Что меняет Customtools

Google описывает предпочтение пользовательских функций, например view_file и search_code, когда также доступен bash. Это важно, если приложение уже определило узкие инструменты с предсказуемыми результатами и разрешениями.^[1]

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

Это иллюстративный сценарий, а не зафиксированный ответ одной из моделей. Customtools не гарантирует конкретный вызов, не отменяет необходимость объявлять функции и не заменяет проверки разрешений в приложении. Решение об исполнении вызова и возвращаемом результате остаётся за приложением.

Различие наиболее существенно после наблюдения проблемы выбора инструментов. Если обычная модель уже выбирает нужную функцию и выполняет задачу, смена варианта добавляет ещё одну переменную без предварительно определённого улучшения для измерения.

Customtools — не уровень рассуждений

У Gemini 3.1 Pro отдельные уровни рассуждений low, medium и high. В нативном generateContent по умолчанию используется high; minimal этой моделью не поддерживается. Это настройки генерации, а не альтернативные ID моделей.^[2]

Переход с low на high может изменить бюджет рассуждений для задачи. Смена ID на Customtools направлена на поведение выбора инструментов. Если поменять оба параметра сразу, иной ответ не покажет, какое изменение повлияло на результат.

Для полезного сравнения сохраните одинаковые промпт, объявления инструментов, историю диалога, уровень рассуждений и лимит вывода. Google также рекомендует оставлять температуру 1.0 для Gemini 3. Сравнивайте выполнение запрошенной работы, вызванные инструменты, корректность аргументов и указанное в ответе использование. Это рекомендации по оценке, а не измеренные преимущества одного из вариантов.

Обычная Preview тоже работает с функциями

Официальная спецификация обычной модели указывает поддержку вызова функций. Суффикс Customtools не нужен, чтобы объявить функцию, получить её вызов, исполнить в приложении и вернуть результат.^[1]

Для интерфейса функций используйте нативное tools[].functionDeclarations. При продолжении диалога сохраняйте возвращённые части содержимого и подписи рассуждений. Сбой из-за отсутствующей подписи, неверной схемы аргументов или некорректно собранного ответа инструмента — проблема протокола; смена имён модели не подтверждает её устранение.

Справочник API Gemini 3.1 Pro перечисляет нативные поля и их ограничения. Начните с небольшой функции с проверяемым результатом, прежде чем добавлять целый набор инструментов.

Выбирайте под свой реальный сценарий

Сначала выбирайте обычную Preview, если основная работа — генерация текста, объяснение кода, извлечение данных из документов или мультимодальный анализ. Это также допустимая отправная точка для приложения с инструментами. До оценки определите, как выглядит успешный результат.

Сравнивайте с Customtools, когда приложение сочетает bash с пользовательскими инструментами и есть конкретная воспроизводимая проблема выбора. Подготовьте короткий набор типичных случаев: один для узкой функции, один, где действительно нужна оболочка, и один, где не следует вызывать инструменты. Проверяйте выбранное действие и окончательный результат.

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

Страница цен Google объединяет оба ID в одной таблице тарифов модели. Это не делает взаимозаменяемыми рассуждения, выбор уровня обработки или использование токенов. При сравнении запросов проверяйте применимые текущие тарифы и фактическое использование.^[3]

Какую версию подключает SeedRouter?

Страница Gemini 3.1 Pro использует gemini-3.1-pro-preview. Вариант Customtools этой интеграцией не подключён. Страница предоставляет Playground обычной модели и актуальные цены групп; справочник API описывает текущие границы проверки.

USD за 1 млн токенов

Элемент	googlellm · Некэшированные входные токены: ≤ 200 000	googlellm · Некэшированные входные токены: > 200 000	googlellm-vertext · Некэшированные входные токены: ≤ 200 000	googlellm-vertext · Некэшированные входные токены: > 200 000
Вход	0,80 $	1,60 $	1,00 $	2,00 $
Выход, включая рассуждения	4,80 $	7,20 $	6,00 $	9,00 $
Кэшированный вход	0,08 $	0,16 $	0,10 $	0,20 $

Тарифы обработки Standard. Для порога 200,000 токенов учитывается некэшированный вход. Кэшированные токены оплачиваются отдельно и не оплачиваются повторно как некэшированный вход. Плата за инструменты и хранение кэша не входит в эти примеры расчёта токенов.

Указывайте в приложении точный ID обычной модели. Для контролируемой оценки задавайте настройки обработки явно и проверяйте результат на своей задаче, прежде чем считать конфигурацию пригодной для рабочей среды.

Частые вопросы

Оба имени модели Gemini 3.1 Pro официальные?

Да. Google документирует gemini-3.1-pro-preview и gemini-3.1-pro-preview-customtools на одной странице модели. Второе имя — специализированный вариант, а не неофициальное написание.

Customtools заменяет обычный вызов функций?

Нет. Обычный вызов функций уже доступен в стандартной Preview. Customtools меняет предпочтения модели в сценарии, сочетающем пользовательские инструменты и bash; функции по-прежнему объявляет и исполняет приложение.

Customtools всегда лучше для программирования?

Google не делает такого общего заявления. Документированное отличие касается выбора инструментов, а страница модели предупреждает о колебаниях качества вне целевого сценария. Сравнивайте поведение, нужное именно вашему приложению для программирования.

Источники

Проверено 17 октября 2026 года. Сравнение выше основано на документации, а не на новом бенчмарке качества.

Google: спецификация модели Gemini 3.1 Pro — официальные ID, лимиты ввода и вывода, вызов функций и отличие Customtools.
Google: нативное руководство для разработчиков Gemini 3 — уровни рассуждений, настройки нативного запроса и рекомендации по температуре.
Google: цены Gemini API — общая официальная таблица цен двух ID моделей.

Gemini 3.1 Pro Preview и Customtools: что выбрать?