Что поддерживает Nano Banana 2
Публичные цены указаны на 24 сентября 2026 года; актуальный список — в разделе Цены на API моделей ИИ. Модель приходит по официальному каналу Google, и изображения от 1K до 4K стоят дешевле стандартной цены Google ($0.067 при 1K, $0.101 при 2K, $0.151 при 4K). Если нужны только размеры от 1K до 4K, Nano Banana 2.1 стоит $0.045 за вызов и принимает тот же запрос.

Результат примера генерации ниже: 2K, 16:9. Промпт: Generate an image of a night market food stall with a hand-painted sign that reads "NOODLES", warm lantern light.
Параметры и ограничения
Google отключил
gemini-3.1-flash-image-preview 25 июня 2026 года, согласно своей странице об устаревших моделях. В LaoZhang API ID с суффиксом -preview сопоставлены соответствующим стабильным ID, но лучше сразу указывать стабильный ID gemini-3.1-flash-image. Чтобы сравнить все пять моделей Nano Banana, откройте обзор Nano Banana.
Подготовка к вызову
1
Создайте API-ключ
В разделе Управление токенами откройте диалог создания токена (创建令牌), в поле Режим оплаты (计费模式) выберите «сначала по использованию» (按量优先, рекомендуется) или «оплата за вызов» (按次计费) и нажмите Создать (创建). У Nano Banana 2 есть только цена за вызов, поэтому ключ с режимом «оплата по использованию» (按量计费) её вызвать не может; когда запрос тарифицируется, описано в правилах оплаты.

2
Задайте ключ и установите зависимости
3
Добавьте функцию сохранения для cURL
Для примеров с cURL нужен Если в ответе нет изображения, функция выводит поля
jq. Определите эту shell-функцию: она сохраняет последнее изображение из нативного ответа Gemini (если вместе с результатом пришли промежуточные изображения, финальное — последнее) с расширением, которое соответствует mimeType:error, promptFeedback и finishReason.Генерация изображения
- cURL
- Python
candidates[0].content.parts[].inlineData.data, а формат указывает mimeType. Оба примера декодируют его и сохраняют соответствующий файл PNG, JPEG или WebP.
Крупные размеры рендерятся дольше, поэтому оставьте в клиенте большой таймаут; в примерах он равен 300 секундам.
Размеры вывода
imageSize принимает четыре значения от 512 до 4K, с заглавной K; по умолчанию используется 1K. Google публикует для Nano Banana 2 такие размеры в пикселях:
При
512 квадратное изображение имеет размер 512×512; остальные размеры 512px приведены в руководстве Google по генерации изображений.
Редактирование изображений
Сначала отправьте инструкцию, затем референсные изображения частямиinlineData, а в промпте ссылайтесь на изображения по порядку («первое изображение», «второе изображение»). Nano Banana 2 принимает до 14 референсов: не больше 10 изображений объектов и 4 изображений персонажей.
- cURL
- Python
Этот запрос объединяет два локальных файла. Собирайте тело через
jq, чтобы большие изображения не превысили лимиты аргументов shell, и следите, чтобы mimeType соответствовал файлу:inlineData частью fileData с URL изображения:
Привязка изображения к поиску Google
Добавьте инструментgoogleSearch, чтобы изображение опиралось на актуальные данные, например прогноз погоды или свежие результаты. Разрешите TEXT в responseModalities, чтобы вместе с изображением вернулся и текст, который напишет модель:
OpenAI-совместимый маршрут
Если приложение уже использует OpenAI SDK, вызывайте Nano Banana 2 через chat completions. На этом маршруте нет настроек соотношения сторон и размера, поэтому промпт без изображений возвращает квадратное изображение 1K. Изображение приходит как data URL в Base64 внутриmessage.content. Сохраните скрипт как nano_banana_2_chat.py:
Ошибки и оплата
Передавайте значения из этих списков:- Соотношения
1:4,4:1,1:8и8:1работают только в Nano Banana 2 и Nano Banana 2.1. - Размеры в нижнем регистре, например
2k, Google отклоняет. - Запрос может вернуть HTTP 200 без изображения, например если промпт не просит изображение или проверка безопасности блокирует результат. Он тарифицируется как один вызов. Проверьте
finishReason(иpromptFeedback, если он есть), затем измените промпт или референсы, прежде чем отправлять снова; см. раздел «Как не платить за пустые ответы» в обзоре Nano Banana. - HTTP 401 означает неверный ключ или заголовок
Authorization: Bearer. Ответы 429 и 5xx повторяйте с нарастающей задержкой, а перед повторной отправкой запроса с таймаутом сверьтесь с журналом вызовов.
Частые вопросы
Как получить вывод 512px?
В нативном маршруте Gemini задайтеgenerationConfig.imageConfig.imageSize строкой 512. Это значение принимает только Nano Banana 2; остальные значения перечислены в разделе «Размеры вывода».
Как изменить уровень рассуждения и влияет ли он на цену?
Nano Banana 2 и Nano Banana 2 Lite поддерживают два уровня рассуждения —minimal (по умолчанию) и high, чтобы выбирать между скоростью и качеством, и LaoZhang API передаёт эту настройку без изменений. В нативном маршруте Gemini задайте её в generationConfig.thinkingConfig.thinkingLevel, например "thinkingConfig": {"thinkingLevel": "high"}.
Уровень не влияет на цену: LaoZhang API тарифицирует только за вызов, поэтому запрос с high стоит столько же, сколько обычный вызов Nano Banana 2 (сам Google тарифицирует токены рассуждения дополнительно). Nano Banana Pro рассуждает всегда, и её уровень изменить нельзя.
Как включить привязку к поиску изображений и какие у неё ограничения?
ДобавьтеsearchTypes в инструмент Google Search из раздела «Привязка изображения к поиску Google» и перечислите в нём webSearch и imageSearch:
- Инструмент без
searchTypesиспользует только веб-поиск, а одинimageSearch— только поиск изображений. - Если указаны оба типа, как в примере, допустим любой из них; выполнять ли поиск и какого типа, решает модель.
searchTypesдолжен быть объектом, массив не действует. Если поиск изображений выполнялся,groundingMetadataв ответе содержитimageSearchQueries.
- Привязку к поиску изображений поддерживают только Nano Banana 2 и Nano Banana 2.1.
- Поиск изображений пока не может использовать найденные в интернете реальные изображения людей.
- Если вы показываете результаты с привязкой конечным пользователям, нужно показывать и поисковые подсказки.
Связанные материалы и источники
- Обзор Nano Banana — сравнение пяти моделей, двух протоколов и оплаты
- Nano Banana 2.1 — новая версия: от 1K до 4K по более низкой цене за вызов
- Nano Banana 2 Lite — недорогие изображения 1K
- Nano Banana Pro — сложные макеты и ассеты, критичные для бренда
- Редактирование Standard — перенос правок с
gemini-2.5-flash-imageна Nano Banana 2 - Google: Nano Banana image generation — размеры, соотношения сторон, лимиты референсов, рассуждение и привязка
- Google: справочник generateContent — поля
imageConfig,thinkingConfigи инструмента Google Search - Google: устаревшие модели Gemini API — даты отключения моделей
- Журнал вызовов — статус и списание по запросу