Перейти к основному содержанию

Обзор

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.045 за запрос, одинаковая цена для 1K / 2K / 4K, снижена с $0.05 с 13 октября 2026 года), так и на основе tokens ($0.66 за ввод / $13.2 за вывод на 1M tokens). Nano Banana 2 остаётся доступной по той же цене, и Google не объявляла дату прекращения её поддержки.
Все API для работы с изображениями являются синхронными — здесь нет task ID для опроса, и в случае отключения клиента результат будет утерян, а запрос всё равно будет тарифицирован. Задайте достаточный таймаут для этой модели; см. Основы и лучшие практики Image API.

API генерации изображений по тексту

Генерируйте изображения по текстовому prompt с помощью интерактивного Playground.

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

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

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

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

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

Интегрируйте (или отладьте) генерацию текста в изображение + редактирование изображений с помощью Nano Banana 2.1 (gemini-nano-banana-2.1) в этом проекте.

Прочитайте документацию перед написанием кода: загрузите https://docs.apiyi.com/en/api-capabilities/gemini-nano-banana-2.1/overview.md для получения версии этой страницы в виде чистого текста. Для получения подробных параметров добавьте .md …

  1. Таймауты: используйте нативный формат Gemini POST https://api.apiyi.com/v1beta/models/gemini-nano-banana-2.1:generateContent и установите таймаут клиента на …

Всего 7 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.

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

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

Более высокое визуальное качество по сравнению с 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 → тарификация по tokens
  • Pay-per-request или Pay-per-request Priority → тарификация за запрос
  • ⚠️ Не выбирайте Hybrid billing

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

Снижение цен на 10% с 13 октября 2026 года: $0.05 → $0.045 за запрос (одинаково для 1K / 2K / 4K).
  • Почему: при тарификации по tokens изображения 1K / 2K уже стоили всего $0.02–$0.04 за штуку, из-за чего $0.05 за запрос выглядели дорого, поэтому мы также снизили цену за запрос. Для 4K тарификация за запрос теперь почти на 30% дешевле, чем по tokens ($0.06 и более).
  • Цены при тарификации по tokens не изменились: $0.66 вход / $13.2 выход за 1M tokens.
  • Еще выгоднее: с учетом бонуса за пополнение в 10%–20% фактическая стоимость за запрос составляет около $0.038–$0.041.

Тарификация по tokens

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

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

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

Параметры, влияющие на стоимость

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

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

Grounding с Google Search: тарификация за поисковый запрос

Для изображений, требующих актуальной информации (карточки погоды, рыночные графики, постеры недавних событий), подключите инструмент googleSearch:
В наших тестах grounding срабатывал в 3 случаях из 3, и модель самостоятельно выполняла по 2 поисковых запроса на один запрос. Каждый запрос стоит $0.014 ($14 за 1 000). Модель сама решает, сколько запросов выполнять, и ограничить это число заранее нельзя, поэтому закладывайте в бюджет 2–3 поисковых запроса на запрос.
Плата за поиск взимается и поверх тарификации за запрос: $0.045 за запрос покрывает только генерацию изображения; при подключении 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.045) будет более выгодной.
Ограничений на параллельные запросы нет — отправляйте параллельные запросы свободно; они не встают в очередь и не блокируют друг друга. Важно учитывать timeout: запросы в 4K или в пиковые часы могут занимать некоторое время (в наших тестах большинство 4K-запросов длились 30–50 секунд, единичные — более 2 минут), поэтому установите таймаут клиента на 360 секунд. Если вы периодически сталкиваетесь с ошибками 429, укажите NB-Enterprise в качестве резервной группы вашего token.
Каждое выходное изображение содержит невидимый водяной знак SynthID (маркер Google для контента, созданного ИИ). Он незаметен визуально и никак не влияет на использование.

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