Как работать с Gemini 3

Семейство и пределы

Серия, пока в предварительной версии:

• Gemini 3.1 Pro: сложные задачи — широкие знания, рассуждения над текстом, картинками и видео.
• Gemini 3 Flash: по словам Google, интеллект уровня Pro при скорости и цене Flash; единственная с бесплатным уровнем в API.
• Gemini 3.1 Flash-Lite: дешёвые массовые задачи.
• Для картинок: Gemini 3 Pro Image (Nano Banana Pro) и Gemini 3.1 Flash Image (Nano Banana 2).

Текстовые модели принимают до 1 миллиона токенов, выдают до 64 тысяч; знания по январь 2025 года, за свежим отправляйте модель в поиск. Gemini 3.1 Pro бесплатна только в Google AI Studio.

Уровень размышлений

thinking_level — верхняя планка размышлений, а не число токенов: по словам Google, разрешение, а не гарантия.

• minimal: почти без размышлений, для чата и потока запросов; по умолчанию у Flash-Lite, на Gemini 3.1 Pro не поддерживается, отключения не гарантирует.
• low: минимальные задержка и цена, простые указания.
• medium: середина для большинства задач.
• high: максимальная глубина, первого слова ждать дольше; по умолчанию у Pro и Flash.

Старый thinking_budget пока работает, но Google советует thinking_level ради предсказуемости. Через слой совместимости с OpenAI ничего не меняйте: reasoning_effort переводится сам.

Температура и подписи мыслей

• temperature: оставьте 1.0, значение по умолчанию; явно заданную в коде уберите.
• История у Google: передавайте previous_interaction_id (Google рекомендует этот режим) — подписями мыслей, зашифрованными слепками рассуждения, займётся сервер.
• История своя: возвращайте блоки мыслей с подписями в каждом запросе, иначе их подлинность не подтвердить; на них же держится пошаговое редактирование картинок.

Как писать запросы

Gemini 3 рассуждает сама, и приёмы для старых моделей ей мешают.

• Коротко и прямо: многословные приёмы для старых моделей Gemini 3 может разбирать вместо дела; при переходе с 2.5 уберите их и поставьте thinking_level: high.
• Манера: по умолчанию ответы короткие; разговорчивого собеседника задайте прямо.
• Большие данные: сначала книга, код или видео, вопрос — в конце, с отсылкой к материалам выше.

Инструменты

• Один запрос: встроенные инструменты Google (поиск, карты, поиск по файлам, выполнение кода, чтение страниц по ссылке) можно сочетать со своими функциями и получить ответ по схеме, например JSON.
• Картинки в Flash: с выполнением кода Gemini 3 Flash сама пишет код на Python, чтобы увеличить, обрезать или разметить картинку: показания прибора, сумма по чеку, график.
• Для картинок: модели рисуют с разборчивым текстом до 4K и могут сходить в поиск за свежими данными.

Переход с Gemini 2.5

1. Уберите расписанные цепочки рассуждений, поставьте thinking_level: high.
2. Уберите явную temperature.
3. Для плотных PDF проверьте media_resolution_high: по умолчанию PDF могут стоить больше токенов, видео — меньше; не влезает в контекстное окно — снизьте разрешение медиа.
4. Сегментация изображений (маски объектов по пикселям) в Gemini 3 Pro и 3 Flash не поддерживается — оставьте для неё Gemini 2.5 Flash с выключенными размышлениями.
5. Управление компьютером встроено, отдельная модель не нужна; добавились карты Google и встроенные инструменты вместе с функциями.

Примечание: Google пометил это руководство устаревшим и отсылает к странице о Gemini 3.5 Flash.