Обзор
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 для всех новых проектов.
API генерации изображений по тексту
API редактирования изображений
Поручите интеграцию 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…
- Таймауты: используйте нативный формат Gemini
POST https://api.apiyi.com/v1beta/models/gemini-nano-banana-2.1:generateContentи установите таймаут клиента на …
Всего 7 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.
От чего защищает этот prompt
От чего защищает этот prompt
Ключевые возможности
Улучшенное качество изображений
Более точный текст
Более стабильное многоэтапное редактирование
Три уровня рассуждения
Вывод в разрешении до 4K
14 соотношений сторон
Объединение нескольких референсов
Заземление через Google Search
googleSearch для изображений, требующих актуальной информации, например карточек погоды или рыночных графиковОтличия от Nano Banana 2
Тарифы
- Pay-as-you-go или Pay-as-you-go Priority → тарификация по tokens
- Pay-per-request или Pay-per-request Priority → тарификация за запрос
- ⚠️ Не выбирайте Hybrid billing
Тарификация за запрос
Тарификация по tokens
Тарификация по tokens: реальные списания в продакшене
По умолчанию Nano Banana 2.1 выполняет рассуждение перед генерацией (уровень по умолчанию: medium). Помимо tokens изображений, каждое изображение генерирует примерно 400–1300 tokens рассуждения и других выходных tokens, которые тарифицируются вместе с изображением по ставке $13.2 / 1M. Поэтому стоимость одного изображения при тарификации по tokens не фиксирована — она варьируется. Приведенная ниже таблица составлена на основе реальных запросов с тарификацией по tokens от 2026-10-07; суммы представляют собой фактические списания в консоли (разрешение определено по выходным tokens):thoughtsTokenCount в usageMetadata не включен в candidatesTokenCount, однако он учитывается как выходные tokens в ваших журналах APIYI и тарифицируется. Расчет исходя из 1120 / 1680 / 3780 tokens занижает стоимость на 20%–40%. Сверяйте списания по журналам в консоли.Параметры, влияющие на стоимость
thinkingLevel: по умолчанию medium, а high стоит лишь немного дороже
high стоит на 54% дороже), версия 2.1 уже рассуждает по умолчанию, а high просто рассуждает чуть дольше. Смело включайте этот параметр, если требуется точное размещение текста на изображении или строгое соблюдение пропорций диаграмм.
Grounding с Google Search: тарификация за поисковый запрос
Для изображений, требующих актуальной информации (карточки погоды, рыночные графики, постеры недавних событий), подключите инструментgoogleSearch:
Группы
Nano Banana 2.1 доступна в двух группах на APIYI; переключаться между ними можно в настройках вашего token:Pay-as-you-go Priority — он поддерживает тарификацию по tokens для Nano Banana 2 / 2.1 и тарификацию за запрос для Nano Banana Pro, поэтому один token покрывает всю линейку. Укажите Default в качестве основной группы, а NB-Enterprise — в качестве резервной; если основная группа вернет 429, запросы автоматически переключатся на резервную и генерация продолжится.
Разрешения и соотношения сторон
Выходное разрешение
Поддерживаемые соотношения сторон (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. Передавайте его явно, если вам требуется фиксированное соотношение сторон.
Фактические размеры на выходе (в пикселях)
Часто задаваемые вопросы
Nano Banana 2.1 и Nano Banana 2 — это одна и та же модель?
Nano Banana 2.1 и Nano Banana 2 — это одна и та же модель?
gemini-nano-banana-2.1, с более высоким качеством, улучшенной отрисовкой текста и согласованностью в многоэтапных диалогах, а также с другой структурой тарификации (более дорогой ввод, более дешевый вывод изображений, больше tokens на 4K-изображение). Обе модели доступны на APIYI и не влияют друг на друга.Что нужно изменить для перехода с Nano Banana 2?
Что нужно изменить для перехода с Nano Banana 2?
- Измените имя модели с
gemini-3.1-flash-image(или-preview) наgemini-nano-banana-2.1 - Если вы используете
"imageSize": "512", измените его на1K - Если вы рассчитываете стоимость по tokens, сверьтесь с таблицей «фактическая стоимость одного изображения» выше
Будет ли отключена Nano Banana 2?
Будет ли отключена Nano Banana 2?
gemini-3.1-flash-image; компания лишь указывает 2.1 в качестве рекомендуемой замены. Nano Banana 2 на APIYI по-прежнему доступна по прежней цене. Мы сообщим заранее, если что-то изменится.Почему сумма в счете выше, чем предполагают tokens за изображения?
Почему сумма в счете выше, чем предполагают tokens за изображения?
thoughtsTokenCount. Если вы в основном генерируете в 4K, тарификация за запрос ($0.045) будет более выгодной.Есть ли ограничение на параллельные запросы?
Есть ли ограничение на параллельные запросы?
timeout: запросы в 4K или в пиковые часы могут занимать некоторое время (в наших тестах большинство 4K-запросов длились 30–50 секунд, единичные — более 2 минут), поэтому установите таймаут клиента на 360 секунд. Если вы периодически сталкиваетесь с ошибками 429, укажите NB-Enterprise в качестве резервной группы вашего token.Есть ли водяной знак на сгенерированных изображениях?
Есть ли водяной знак на сгенерированных изображениях?
Связанная документация
- Генерация и редактирование изображений Nano Banana 2 — предыдущая версия, поддерживает 512px
- Генерация и редактирование изображений Nano Banana Pro — наивысшее качество
- Руководство разработчика Nano Banana — управление размером, требования к входным изображениям, URL изображений
- Тарифы Nano Banana
- Обработка ошибок изображений Gemini