Skip to main content

​
Обзор

Nano Banana 2.1 — это модель генерации изображений, выпущенная Google 6 октября 2026 года. Идентификатор модели — gemini-nano-banana-2.1, и она была запущена в статусе общей доступности (GA). Это обновление для Nano Banana 2 (gemini-3.1-flash-image): она сохраняет скорость уровня Flash, улучшая при этом качество изображений, рендеринг текста внутри изображений и согласованность при многоэтапном редактировании, а также устраняет артефакты тайлинга предыдущей версии. Google рекомендует версию 2.1 для всех новых проектов.
🆕 Релиз 6 октября 2026 года: Уже доступно на APIYI с двумя вариантами тарификации: за запрос ($0.05 за запрос, одинаковая цена для 1K / 2K / 4K) и по токенам ($0.66 за входные / $13.2 за выходные на 1M tokens). Nano Banana 2 по-прежнему доступна по той же цене, и Google не объявляла дату прекращения её поддержки.
Все API для работы с изображениями являются синхронными — здесь нет task ID для опроса, и в случае отключения вашего клиента результат будет потерян, тогда как запрос всё равно будет протарифицирован. Задайте достаточно большой таймаут для этой модели; подробнее см. в руководстве Основы и лучшие практики Image API.

API Text-to-Image

Генерация изображений по текстовому prompt с интерактивным Playground.

API редактирования изображений

Загрузка изображений вместе с инструкцией для получения отредактированного результата с интерактивным Playground.

​
Поручите интеграцию ИИ-агенту

Если вы ведете разработку с помощью Codex, Claude Code или Cursor, скопируйте приведенный ниже prompt в него. Сначала он получит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код для вашего стека. Самые распространенные подводные камни — таймауты, безопасный парсинг parts, сжатие при загрузке и параметры разрешения — уже четко сформулированы в требованиях.

Поручите ИИ-агенту для написания кода интегрировать или отладить генерацию изображений по тексту и редактирование изображений Nano Banana 2.1. Скопируйте и вставьте в Codex, Claude Code, Cursor и т. д.

​
Ключевые возможности

Улучшенное качество изображений

Более высокое визуальное качество по сравнению с Nano Banana 2; устранены артефакты тайлинга предыдущей версии

Более точный текст

Более четкий текст на изображениях с меньшим количеством опечаток — отлично подходит для постеров, маркетинговых материалов и инфографики

Более стабильное многоэтапное редактирование

Персонажи и сцены сохраняют согласованность в ходе диалогового редактирования

Три уровня рассуждения

minimal / medium / high, по умолчанию medium — на один уровень больше, чем в предыдущей версии

Вывод в разрешении до 4K

1K / 2K / 4K; при тарификации за запрос 4K стоит столько же, сколько 1K

14 соотношений сторон

Включая сверхвысокие и сверхширокие 1:4, 4:1, 1:8 и 8:1; по данным Google, широкие форматы выглядят лучше в более высоком разрешении

Объединение нескольких референсов

До 10 референсов объектов + 4 референса персонажей + 3 референса стиля

Заземление через Google Search

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

​
Отличия от Nano Banana 2

Что выбрать:
  • Новые проекты → Nano Banana 2.1: качество выше и дешевле за запрос
  • Уже используете Nano Banana 2 → для переключения достаточно сменить имя модели; если в вашем коде используется уровень 512, сначала измените его на 1K
  • Нужны миниатюры 512px → оставайтесь на Nano Banana 2 или используйте Nano Banana 2 Lite
  • Требуется максимальное качество → Nano Banana Pro ($0.09 за запрос)

​
Тарифы

Выбор режима тарификации: Nano Banana 2.1 поддерживает два режима тарификации, которые выбираются параметром «Billing model» при создании token:
  • Pay-as-you-go или Pay-as-you-go Priority → тарификация по token
  • Pay-per-request или Pay-per-request Priority → тарификация за запрос
  • ⚠️ Не выбирайте Hybrid billing

​
Тарификация за запрос

​
Тарификация по token

Цены на модели синхронизированы с официальным сайтом и могут меняться вслед за ним; таблица выше приведена только для справки — официальные данные всегда указаны на вкладке Model Pricing в верхнем меню навигации: Model Pricing.

​
Тарификация по token: реальные списания в продакшене

Nano Banana 2.1 по умолчанию выполняет рассуждение перед генерацией (уровень по умолчанию: medium). Помимо tokens изображений, каждое изображение генерирует примерно 400–1300 tokens рассуждений и других выходных tokens, которые тарифицируются вместе с изображением по ставке $13.2 / 1M. Поэтому стоимость одного изображения при тарификации по token не фиксирована — она варьируется. В таблице ниже приведены данные реальных запросов с тарификацией по token от 2026-10-07; суммы представляют собой фактические списания в консоли (разрешение определено по количеству выходных tokens): Распределение 60 запросов с тарификацией по token за этот день:
Какой режим тарификации выбрать:
  • 1K / 2K → по token: обычно $0.02–$0.04 за изображение, что ниже цены $0.05 за запрос
  • 4K → за запрос: фиксированные $0.05, тогда как тарификация по token стоит $0.06 или больше
  • Множество референсных изображений в одном запросе (например, 10+): входные tokens повышают стоимость по token почти до $0.05 или выше, поэтому для них также используйте тарификацию за запрос
С учётом нашего бонуса за пополнение ваши реальные расходы будут ещё ниже.
Почему расчёт только по tokens изображений занижает стоимость: thoughtsTokenCount в usageMetadata не входит в candidatesTokenCount, но учитывается как выходные tokens в ваших логах APIYI и подлежит оплате. Оценка исходя из 1120 / 1680 / 3780 tokens занижает стоимость на 20%–40%. Сверяйте данные со списаниями в логах консоли.

​
Параметры, влияющие на ваши расходы

​
thinkingLevel: по умолчанию — medium, а high стоит лишь немного дороже

В отличие от Nano Banana 2 (по умолчанию minimal, где high стоит на 54% дороже), версия 2.1 уже рассуждает по умолчанию, а high просто рассуждает немного дольше. Смело включайте этот параметр, когда требуется точное расположение текста на изображении или выверенные пропорции диаграмм.

​
Google Search grounding: тарифицируется за поисковый запрос

Для изображений, требующих актуальной информации (карточки погоды, графики рынков, плакаты недавних событий), подключите инструмент googleSearch:
В наших тестах grounding срабатывал в 3 случаях из 3, и модель самостоятельно выполняла по 2 поисковых запроса на запрос. Каждый запрос стоит $0.014 ($14 за 1 000). Модель сама решает, сколько запросов выполнить, и ограничить это заранее нельзя, поэтому закладывайте в бюджет 2–3 запроса на каждый запрос.
Плата за поиск взимается и при тарификации за запрос: $0.05 за запрос покрывают только изображение; при подключении googleSearch каждый поисковый запрос оплачивается дополнительно.

​
Группы

Nano Banana 2.1 доступна в двух группах на APIYI; переключаться между ними можно в настройках вашего token: Рекомендуемый режим тарификации token: выберите Pay-as-you-go Priority — он поддерживает тарификацию по tokens для Nano Banana 2 / 2.1 и тарификацию за запрос для Nano Banana Pro, поэтому один token покрывает всю линейку. Укажите Default в качестве основной группы, а NB-Enterprise — в качестве резервной; если основная группа вернет 429, запросы автоматически переключатся на резервную и генерация продолжится.

​
Разрешения и соотношения сторон

​
Выходное разрешение

512 не поддерживается: "imageSize": "512" возвращает 400 Image size 512 is not supported for this model (тарификация не производится). Измените это значение при переходе с Nano Banana 2.

​
Поддерживаемые соотношения сторон (14)

1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 Если вы опустите aspectRatio, модель выберет соотношение сторон на основе содержимого: в наших тестах промпты с описанием сцен в основном давали 16:9, а промпты для плакатов — 2:3 или 3:4. Передавайте его явно, если вам требуется фиксированное соотношение сторон.

​
Фактические размеры на выходе (в пикселях)

Измерения проведены 2026-10-07; «—» означает, что замеры еще не проводились. Обратите внимание, что соотношение 8:1 при 1K составляет 2928×352, что отличается от 3072×384 в Nano Banana 2, поэтому не используйте таблицу размеров Nano Banana 2 для фронтенд-верстки.

​
Часто задаваемые вопросы

Нет. 2.1 — это отдельный ID модели, gemini-nano-banana-2.1, с более высоким качеством, улучшенным рендерингом текста и согласованностью в многоэтапных диалогах, а также с другой структурой тарификации (более дорогой ввод, более дешевый вывод изображений, больше tokens на изображение 4K). Обе модели доступны на APIYI и не влияют друг на друга.
  1. Измените название модели с gemini-3.1-flash-image (или -preview) на gemini-nano-banana-2.1
  2. Если вы используете "imageSize": "512", измените его на 1K
  3. Если вы рассчитываете стоимость по tokens, сверьте ее с приведенной выше таблицей «Фактическая стоимость одного изображения»
Формат запроса, структура ответа, а также редактирование нескольких изображений и многоэтапное редактирование остаются прежними.
По состоянию на 7 октября 2026 года Google не объявляла дату отключения gemini-3.1-flash-image; версия 2.1 указана лишь как рекомендуемая замена. Nano Banana 2 на APIYI остается доступной по той же цене. Если что-то изменится, мы уведомим вас заранее.
Поскольку версия 2.1 выполняет рассуждение по умолчанию, каждое изображение добавляет примерно 400–1300 tokens рассуждения и других выходных tokens, которые тарифицируются по тарифу на вывод вместе с изображением. Вы можете увидеть их в thoughtsTokenCount. Если вы в основном генерируете 4K, тарификация за запрос ($0.05) будет более выгодной.
Лимита на параллельные запросы нет — отправляйте параллельные запросы свободно; они не встают в очередь и не блокируют друг друга. Важен параметр timeout: запросы 4K или запросы в часы пик могут занимать некоторое время (в наших тестах большинство запросов 4K длились 30–50 секунд, некоторые — более 2 минут), поэтому установите таймаут клиента на 360 секунд. Если вы иногда сталкиваетесь с ошибками 429, добавьте NB-Enterprise в качестве резервной группы для вашего token.
Каждое выходное изображение содержит невидимый водяной знак SynthID (метка Google для контента, созданного ИИ). Он незаметен и никак не влияет на использование.

​
Связанная документация