Перейти к основному содержанию
Nano Banana 2 надёжно отрисовывает текст, хорошо справляется с композициями из нескольких референсов и остаётся единственной моделью Nano Banana с размером превью 512px.

Что поддерживает 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 за вызов и принимает тот же запрос.
Лоток с едой на ночном рынке с нарисованной от руки вывеской NOODLES в свете фонарей, сгенерировано Nano Banana 2

Результат примера генерации ниже: 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 есть только цена за вызов, поэтому ключ с режимом «оплата по использованию» (按量计费) её вызвать не может; когда запрос тарифицируется, описано в правилах оплаты.Диалог создания токена в консоли LaoZhang API с режимом оплаты «оплата за вызов» (按次计费)
2

Задайте ключ и установите зависимости

3

Добавьте функцию сохранения для cURL

Для примеров с cURL нужен jq. Определите эту shell-функцию: она сохраняет последнее изображение из нативного ответа Gemini (если вместе с результатом пришли промежуточные изображения, финальное — последнее) с расширением, которое соответствует mimeType:
Если в ответе нет изображения, функция выводит поля error, promptFeedback и finishReason.

Генерация изображения

Изображение приходит в Base64 в 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 изображений персонажей.
Этот запрос объединяет два локальных файла. Собирайте тело через jq, чтобы большие изображения не превысили лимиты аргументов shell, и следите, чтобы mimeType соответствовал файлу:
Напишите, что должно остаться без изменений, а для точного контроля описывайте одно изменение за запрос. Чтобы сохранить внешность людей в серии, передавайте их фотографии как референсы персонажей (до 4). Весь запрос, включая изображения в Base64, должен занимать меньше 20 МБ. Если референс крупный или уже лежит на CDN, замените его часть inlineData частью fileData с URL изображения:
Изображение скачивает сервер, поэтому URL должен открываться без входа в систему; полные условия описаны в обзоре Nano Banana в разделе «Большие изображения и URL».

Привязка изображения к поиску Google

Добавьте инструмент googleSearch, чтобы изображение опиралось на актуальные данные, например прогноз погоды или свежие результаты. Разрешите TEXT в responseModalities, чтобы вместе с изображением вернулся и текст, который напишет модель:
Nano Banana 2 и Nano Banana 2.1 — единственные модели Nano Banana, которые могут использовать результаты поиска изображений Google как визуальные референсы; как это включить, описано в разделе «Частые вопросы». Если вы показываете результаты с привязкой конечным пользователям, показывайте поисковые подсказки так, как требует руководство Google по привязке.

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 повторяйте с нарастающей задержкой, а перед повторной отправкой запроса с таймаутом сверьтесь с журналом вызовов.
Правила оплаты одинаковы для всех моделей Nano Banana.

Частые вопросы

Как получить вывод 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:
Согласно справочнику generateContent от Google:
  • Инструмент без searchTypes использует только веб-поиск, а один imageSearch — только поиск изображений.
  • Если указаны оба типа, как в примере, допустим любой из них; выполнять ли поиск и какого типа, решает модель.
  • searchTypes должен быть объектом, массив не действует. Если поиск изображений выполнялся, groundingMetadata в ответе содержит imageSearchQueries.
Google указывает такие ограничения:
  • Привязку к поиску изображений поддерживают только Nano Banana 2 и Nano Banana 2.1.
  • Поиск изображений пока не может использовать найденные в интернете реальные изображения людей.
  • Если вы показываете результаты с привязкой конечным пользователям, нужно показывать и поисковые подсказки.
Запросы с привязкой стоят $0.014 за каждый поиск сверх цены за вызов. Сколько поисков выполнить, решает модель, а их число видно в журнале вызовов; см. правила оплаты Nano Banana.

Связанные материалы и источники