Чтобы открыть Nano Banana 2.1 в Google AI Studio или в коде, нужен официальный model id: gemini-nano-banana-2.1. Карточка модели на ai.google.dev обновлена 6 октября 2026 года (UTC) и ведёт в Studio ссылкой «Try in Google AI Studio». Ниже — порядок действий для Studio и API без публикации секретов.
Контекст апдейта «что нового» — в отдельной новости на этом сайте; здесь только вызов и параметры.
Официальные точки входа
- Карточка модели:
https://ai.google.dev/gemini-api/docs/models/gemini-nano-banana-2.1 - Документация Image generation:
https://ai.google.dev/gemini-api/docs/image-generation - Google AI Studio — по ссылке с карточки (UI меняется; сверяйте подписи у себя)
Версия Stable: gemini-nano-banana-2.1. Для новых image-проектов docs рекомендуют именно Nano Banana 2.1.
Путь 1: Google AI Studio
Studio удобен для быстрых проб и визуальной проверки промптов.
- Откройте Studio из ссылки на карточке модели.
- Войдите в Google-аккаунт с доступом к Gemini API / Studio в вашем регионе.
- Создайте промпт или чат с генерацией изображений (название режима смотрите в текущем UI).
- Найдите модель Nano Banana 2.1 или выберите пункт, соответствующий
gemini-nano-banana-2.1. Если в пикере пока только старые ярлыки «2 / Pro / Lite», не гадайте: перейдите к API с явным id или обновите список моделей / аккаунт. - Введите промпт, при необходимости приложите референсы (до 14 по docs).
- Выберите разрешение 1K, 2K или 4K. Режим 0.5K на 2.1 не поддерживается.
- При сложных сценах проверьте, доступен ли выбор Thinking (
minimal/medium/high; default — medium). - Сохраните удачные промпты и параметры у себя — UI Studio не заменяет версионирование в репозитории.
Русскоязычный пошаговый гайд с акцентом на формулировки промптов — на nanobanana-ai.ru.
инструкция Nano Banana 2.1 на русском
Путь 2: Gemini API
Что указать обязательно
- model:
gemini-nano-banana-2.1 - промпт (text) и опционально входные Image / Video / PDF
- разрешение выхода из поддерживаемых для 2.1: 1K / 2K / 4K
Пример вызова (псевдокод, без ключа)
Ниже — схема, а не копипаст с секретом. Имена методов берите из актуального GenAI SDK / REST в docs.
Не вставляйте API key в код, который уходит в чат или публичный репозиторий. На странице Image generation (06.10.2026) официальные примеры идут через Interactions API — схема без секретов:
client = genai.Client()(ключ — из окружения / конфигурации клиента, не в тексте статьи)interaction = client.interactions.create(model="gemini-nano-banana-2.1", input="Постер: ночной город, неоновые вывески, читаемая крупная надпись OPEN")- при необходимости
response_formatсimage_size=1K/2K/4Kиgeneration_configсthinking_level=minimal/medium/high - сохраните изображение из
interaction.output_image(или обойдитеsteps, если вывод чередует текст и картинки)
Имена полей сверяйте с актуальной копией docs: SDK обновляется, но model id остаётся gemini-nano-banana-2.1.
Если используете OpenAI-compatible слой или сторонний gateway, всё равно передавайте тот же model id и сверяйте, что провайдер проксирует именно Stable gemini-nano-banana-2.1, а не старый Flash Image.
Смежные материалы по линейке Flash на сайте: обзор Gemini Flash.
Batch API
По карточке модели Batch API — Supported; Flex inference и Priority inference — Not supported. Для пакетной генерации смотрите раздел Batch в docs оптимизации Gemini API.
Параметры, которые чаще всего путают
| Параметр | Значение для 2.1 | Комментарий |
|---|---|---|
| Model id | gemini-nano-banana-2.1 | Не путать с gemini-3.1-flash-image и gemini-3-pro-image |
| Resolutions | 1K, 2K, 4K | 0.5K — не для 2.1 |
| Inputs | Text, Image, Video, PDF | Выходы: Image + Text |
| Token limits | in 131 072 / out 32 768 | По карточке модели |
| Thinking | Supported | minimal / medium (default) / high |
| Search grounding | Supported | Web + Image Search по image gen docs |
| Live API / function calling / caching | Not supported | Не планируйте архитектуру вокруг них на 2.1 |
Референсы и multi-turn в коде
Docs допускают до 14 reference images; в key updates 2.1 — до 4 characters и до 10 objects. В multi-turn диалоге Google заявляет улучшенную character consistency: храните историю хода в одном сеансе, а не собирайте каждый кадр «с нуля» без контекста, если цель — серия правок одного героя.
Подробный угол про правки и референсы — в материале на nanobanana-ai.ru после публикации.
редактирование и 14 референсов в 2.1
Связка Studio → API без потери параметров
Удачный кадр в Studio бесполезен для прода, если вы не перенесли параметры. Минимальный набор для переноса:
- Model id: всегда
gemini-nano-banana-2.1. - Текст промпта один в один (включая язык надписей на картинке).
- Resolution: 1K, 2K или 4K — тот же, что в удачном тесте.
- Thinking level, если меняли относительно default
medium. - Список референсов и порядок их подачи.
Так вы проверяете гипотезу в Studio и закрепляете контракт в коде. Если после переноса картинка «уплыла», сначала сверяйте id и resolution, и только потом переписывайте промпт.
Безопасность и продакшен
- Ключ только в переменных окружения / секретнице.
- Логируйте model id и resolution рядом с job id — так проще отладить «внезапно другая картинка».
- Не полагайтесь на скриншот Studio как на контракт: контракт — id + docs.
- Цены и квоты берите с актуальной страницы Pricing Google; в статье цифры не фиксируем.
- Региональный доступ проверяйте по available regions и статусу аккаунта.
Минимальный чеклист перед первым продом
- Карточка модели открывается и показывает Stable
gemini-nano-banana-2.1. - В песочнице Studio или тестовом ключе проходит один успешный generate на 1K.
- В коде model id зашит строкой, а не «взять что выбрано в UI».
- Для панорам 1:4 / 4:1 / 1:8 / 8:1 на 2K/4K сделан отдельный smoke-тест — Google отдельно отмечает фикс tiling.
- Референсы в тесте не превышают 14; для персонажей держите ориентир «до 4».
- Секреты не попали в git, тикеты и скриншоты чата.
Если что-то из списка падает, сначала чините доступ и id, и только потом усложняйте промпт.
Частые вопросы
Studio не показывает строку «2.1» — модель недоступна?
Не обязательно. UI может отставать или группировать имена. Проверьте вызов API с gemini-nano-banana-2.1 и карточку модели. Если API отвечает ошибкой доступа — вопрос к аккаунту/региону, а не к «пропавшей кнопке».
Можно ли вызвать 2.1 как gemini-3.1-flash-image?
Нет: это код предыдущего workhorse (Nano Banana 2). Для 2.1 используйте gemini-nano-banana-2.1.
Какой Thinking level ставить по умолчанию?
В карточке default — medium. Для простых кадров попробуйте minimal; для плотной инфографики — high, затем сравните качество и стоимость у себя.
Где смотреть полный список image-фич?
На странице Image generation Gemini API — там же model selection и пояснения по референсам, grounding и разрешениям.
Итог
В AI Studio откройте модель через ссылку с карточки и сверьте подпись UI; в коде всегда указывайте gemini-nano-banana-2.1, разрешение 1K–4K и нужный Thinking level. Так вы вызываете именно Nano Banana 2.1, а не соседние ветки Flash Image или Pro.
