Что поддерживает Nano Banana 2.1
Публичные цены на 7 октября 2026 года, проверены 14 октября 2026 года; актуальный список — в разделе Модели и цены. Тестовые вызовы при 1K, 2K и 4K 7 и 14 октября 2026 года были записаны в журнале по $0.045. Модель приходит по официальному каналу Google, а маршрут с оплатой за вызов берёт одну фиксированную цену, поэтому изображения 2K и 4K дешевле стандартной цены Google ($0.0504 при 2K и $0.113 при 4K; см. сравнение с официальными ценами).

Результат примера генерации ниже: 2K, 16:9. Промпт: Generate an image of a corner cafe after rain at dusk, warm light on the wet pavement, with a neon sign that reads "BANANA CAFE".
Параметры и ограничения
Чтобы сравнить все пять моделей Nano Banana, откройте обзор Nano Banana.
Nano Banana 2.1 или Nano Banana 2?
Обе модели принимают одинаковый запрос и возвращают ответ той же формы, поэтому при переходе меняется только ID модели.Новые проекты: Nano Banana 2.1
Меньше цена за вызов при 1K–4K, лучше текст и компоновка.
Превью 512px: Nano Banana 2
В Nano Banana 2.1 нет размера
512. Nano Banana 2 остаётся доступной по той же цене, поэтому существующим интеграциям переходить не нужно.
Nano Banana 2.1, 2K, 16:9: 25 с, $0.045

Nano Banana 2, 2K, 16:9: 21 с, $0.055
Подготовка к вызову
1
Создайте API-ключ
В разделе Управление токенами создайте ключ в группе
default и выберите Режим оплаты (计费模式) — «сначала по использованию» (按量优先, рекомендуется) или «оплата за вызов» (按次计费). Ключ с режимом «оплата по использованию» (按量计费) не может вызывать модели с оплатой за вызов, такие как Nano Banana 2.1.2
Задайте ключ и установите зависимости
3
Добавьте функцию сохранения для cURL
Для примеров с cURL нужен Если в ответе нет изображения, функция выводит поля
jq. Эта shell-функция сохраняет последнее изображение, не являющееся промежуточным, из нативного ответа Gemini с расширением, которое соответствует mimeType:error, promptFeedback и finishReason.
В примерах таймаут равен 300 секундам; оставьте такой же запас в клиенте и в прокси. Изредка запрос выходит за этот предел, поэтому перед повторной отправкой запроса с таймаутом сверьтесь с журналом вызовов.
Генерация изображения
- cURL
- Python
candidates[0].content.parts[].inlineData.data, а формат указывает mimeType. Оба примера декодируют его и сохраняют соответствующий файл PNG, JPEG или WebP.
Если не указать aspectRatio, модель сама выберет кадр по промпту. Размеры в пикселях для 1:1 и 16:9 приведены в таблице в разделе «Подготовка к вызову»; для других соотношений смотрите руководство Google по генерации изображений.
Редактирование изображений
Сначала отправьте инструкцию, затем референсные изображения частямиinlineData, а в промпте ссылайтесь на изображения по порядку («первое изображение», «второе изображение»). Nano Banana 2.1 принимает до 14 референсов: не больше 10 изображений объектов и 4 изображений персонажей.
- cURL
- Python
Этот запрос объединяет два локальных файла. Собирайте тело через
jq, чтобы большие изображения не превысили лимиты аргументов shell, и следите, чтобы mimeType соответствовал файлу:Передача большого изображения по URL
Весь запрос должен занимать меньше 20 МБ. Если референс крупный или уже лежит на CDN, передайте его URL частьюfileData, не скачивая и не кодируя:
- Замените
https://cdn.example.com/your-photo.jpgна URL своего изображения и укажитеmimeType, соответствующий его формату. - Части
fileDataиinlineDataмогут находиться в одном массивеparts; они считаются первым, вторым и следующими референсами по порядку. - Изображение скачивает сервер, поэтому URL должен открываться без входа в систему; полные условия описаны в обзоре Nano Banana в разделе о больших изображениях и URL.
Привязка изображения к поиску Google
Добавьте инструментgoogleSearch, если изображение зависит от актуальных фактов или от того, как выглядит реальная достопримечательность. Этот запрос включает и веб-поиск, и поиск изображений и разрешает TEXT, чтобы вернулся и текст, который напишет модель:
searchTypesдолжен быть объектом. Без него инструмент использует только веб-поиск; одинimageSearchвключает только поиск изображений.- Выполнять ли поиск и какого типа, решает модель. Выполненные запросы отображаются в
groundingMetadata. - Поиск изображений пока не может использовать реальные изображения людей в качестве референсов.
- Если вы показываете результаты с привязкой конечным пользователям, показывайте поисковые подсказки так, как требует руководство Google по привязке.
- Каждый поиск добавляет $0.014 к вызову за $0.045, поэтому запрос с 2 поисками стоит $0.073. Число поисков видно в журнале вызовов; см. правила оплаты Nano Banana.
OpenAI-совместимый маршрут
Если приложение уже использует OpenAI SDK, укажитеbase_url равным https://api.laozhang.ai/v1, а model — gemini-nano-banana-2.1. На этом маршруте нет настроек соотношения сторон, размера и формата: он возвращает PNG 1K, кадр которого модель выбирает по промпту, часто 16:9. Для фиксированного соотношения, 2K и 4K или JPEG используйте нативный маршрут Gemini.
Изображение приходит как data URL в Base64 внутри message.content. Сохраните скрипт как nano_banana_21_chat.py:
Ошибки и оплата
Неверные параметры возвращают HTTP 400 и не тарифицируются.aspectRatio вне списка из 14 соотношений, например 7:3, возвращает 400, возможно с пустым текстом ошибки; сверьте соотношение с таблицей параметров выше. Слишком большое тело запроса возвращает 413; передавайте большие изображения по URL.
- Каждый вызов стоит $0.045 независимо от размера вывода, уровня рассуждения, числа референсов и от того, генерация это или правка.
- Привязка к поиску Google добавляет $0.014 за поиск.
- Запрос может вернуть HTTP 200 без изображения, например если промпт не просит изображение или проверка безопасности блокирует результат. Он тарифицируется как один вызов. Проверьте
finishReason, затем измените промпт или референсы, прежде чем отправлять снова; см. обзор Nano Banana, раздел о пустых ответах. - Ответы 429 и 5xx повторяйте с нарастающей задержкой, а перед повторной отправкой запроса с таймаутом сверьтесь с журналом вызовов.
Частые вопросы
Что поменять при переходе с Nano Banana 2?
Замените ID моделиgemini-3.1-flash-image на gemini-nano-banana-2.1; запрос и ответ остаются прежними. Затем проверьте два момента:
- Запросам с
"imageSize": "512"нужно1K, либо им стоит остаться на Nano Banana 2. Nano Banana 2.1 возвращает для них изображение 1K и тарифицирует вызов. - Без
thinkingLevelNano Banana 2.1 рассуждает на уровнеmedium, а Nano Banana 2 по умолчанию используетminimal. Если нужно более быстрое поведение, явно задайтеminimal.
Как изменить уровень рассуждения и влияет ли он на цену?
В нативном маршруте Gemini задайтеgenerationConfig.thinkingConfig.thinkingLevel равным minimal, medium или high. Высокие уровни тратят больше усилий на компоновку и текст и работают дольше.
"includeThoughts": true, в ответ добавятся текст рассуждений и черновые изображения с пометкой "thought": true. Функция save_image и Python-скрипт их пропускают.
Дороже ли 4K, чем 1K?
Нет. Каждый вызов стоит $0.045: наши тестовые вызовы при 1K, 2K и 4K 7 и 14 октября 2026 года были записаны в журнале по этой сумме. Google тарифицирует по выходным токенам, примерно $0.113 за изображение 4K, согласно его странице цен. Если нужны только изображения 1K, Nano Banana 2 Lite дешевле за вызов.Nano Banana 2.1 или Nano Banana Pro?
Начните с Nano Banana 2.1 за $0.045 за вызов. Переходите на Nano Banana Pro (gemini-3-pro-image, $0.09 за вызов), когда изображение зависит от знаний о мире, многоязычного текста или точных деталей бренда, либо когда правке нужны референсы стиля и до 5 референсов персонажей. Обе модели принимают одинаковый запрос, поэтому перед выбором проверьте собственные промпты на обеих.
Один и тот же промпт в 2K и 16:9 14 октября 2026 года занял 25 с на Nano Banana 2.1 и 69 с на Nano Banana Pro:

Nano Banana 2.1, 2K, 16:9: 25 с, $0.045

Nano Banana Pro, 2K, 16:9: 69 с, $0.09
Нужен ли аккаунт Google или ключ AI Studio?
Нет. Достаточно API-ключа LaoZhang API в группеdefault; запросы идут на https://api.laozhang.ai в нативном формате Gemini или в OpenAI-совместимом формате, описанных на этой странице.
Тарифицируется ли запрос при ошибке или без изображения?
Любой ответ апстрима не 200 (400 при неверных параметрах, 429 или 5xx до генерации) не тарифицируется. HTTP 200 тарифицируется как один вызов, с изображением или без; см. раздел «Ошибки и оплата» и правила оплаты и ошибок.Можно ли получить вывод в JPEG?
Да. В нативном маршруте Gemini добавьтеimageOutputOptions в generationConfig.imageConfig:
mimeTypeпринимаетimage/png(по умолчанию) иimage/jpeg.image/webpвозвращает 400 и не тарифицируется.compressionQualityдействует только для JPEG и принимает значения от 0 до 100; чем меньше значение, тем меньше файл.- Значение
inlineData.mimeTypeв ответе меняется наimage/jpeg. Одно и то же квадратное изображение 1K занимает около 1,1 МБ в PNG и 40–60 КБ в JPEG, по той же цене. - OpenAI-совместимый маршрут не позволяет задать формат и всегда возвращает PNG.
Почему OpenAI-совместимый маршрут возвращает альбомные изображения?
Этот маршрут не может передать соотношение сторон, поэтому модель выбирает кадр по промпту, часто 16:9. Для квадратного или портретного вывода используйте нативный маршрут Gemini и задайтеaspectRatio.
Связанные материалы и источники
- Обзор Nano Banana — сравнение пяти моделей, двух протоколов и оплаты
- Nano Banana 2 — когда нужен вывод 512px
- Nano Banana 2 Lite — недорогие изображения 1K
- Nano Banana Pro — сложные макеты и ассеты, критичные для бренда
- Протокол Gemini — структура нативных запросов и настройка SDK
- Google: Gemini Nano Banana 2.1 — официальные возможности и ограничения
- Google: Nano Banana image generation — размеры, соотношения сторон и лимиты референсов
- Журнал вызовов — статус и списание по запросу