Перейти к основному содержанию
Nano Banana 2 Lite — модель изображений Gemini, которую Google называет самой быстрой и дешёвой: она рассчитана на изображения 1K, быстрые правки и большие объёмы.

Что поддерживает Lite

На OpenAI-совместимом маршруте соотношение сторон задать нельзя: промпт без изображений возвращает квадратное изображение.
Современная логистическая панель на тёмно-сером фоне с бирюзовыми акцентами, сгенерировано Nano Banana 2 Lite

Результат примера генерации ниже: 1K, 16:9. Промпт: Generate an image of a modern logistics dashboard on a dark gray background with cyan highlights.

Google отмечает, что Lite не оптимизирована для большого числа референсов и многошаговой правки. Для таких задач, для вывода 2K или 4K и для привязки к поиску Google используйте Nano Banana 2.1 или Nano Banana 2, а для самых сложных макетов — Nano Banana Pro. Все пять моделей сравниваются в обзоре Nano Banana.

Подготовка к вызову

1

Создайте API-ключ

В разделе Управление токенами откройте диалог создания токена (创建令牌), в поле Режим оплаты (计费模式) выберите «сначала по использованию» (按量优先, рекомендуется) или «оплата за вызов» (按次计费) и нажмите Создать (创建). У Lite есть только цена за вызов, поэтому ключ с режимом «оплата по использованию» (按量计费) её вызвать не может; когда запрос тарифицируется, описано в правилах оплаты.
2

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

3

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

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

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

Изображение приходит в Base64 в candidates[0].content.parts[].inlineData.data, а формат указывает mimeType. Оба примера декодируют его и сохраняют соответствующий файл PNG, JPEG или WebP.

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

Поставьте в parts сначала инструкцию, а за ней изображение. Локальный файл передаётся как inlineData в Base64 с mimeType, соответствующим файлу.
Собирайте тело запроса через jq, чтобы большое изображение не превысило лимиты аргументов shell:
Типичные правки в Lite — замена фона, смена цвета, наклейки и быстрые вариации. Укажите в инструкции, что должно остаться без изменений. Для композиций из нескольких референсных изображений используйте Nano Banana 2.1 или Nano Banana 2.

OpenAI-совместимый маршрут

Если приложение уже использует OpenAI SDK, вызывайте Lite через chat completions. На этом маршруте нет настроек соотношения сторон и размера, поэтому промпт без изображений возвращает квадратное изображение 1K. Изображение приходит как data URL в Base64 внутри message.content. Сохраните скрипт как nano_banana_lite_chat.py:
Сгенерируйте изображение, а затем отредактируйте локальный файл:

Lite под высокой нагрузкой

Lite подходит для черновиков, превью и интерактивных приложений, которые создают много изображений. Платформа не ограничивает параллельность, а редкий 429 вызван ёмкостью апстрима; см. Параллельность и 429. Для рабочего трафика:
  1. Переиспользуйте HTTP-соединения, а не создавайте новый клиент для каждого изображения.
  2. Повторяйте ответы 429 и 5xx и сетевые ошибки с экспоненциальной задержкой и случайным разбросом.
  3. Задайте бизнес-таймаут и перед повтором запроса с таймаутом проверьте журнал вызовов, чтобы не оплатить его дважды.
  4. Не повторяйте ответ HTTP 200 без изображения. Он уже оплачен, а повторная отправка того же содержимого обычно снова ничего не возвращает.
  5. Записывайте для каждого вызова модель, код статуса, задержку и время запроса.
  6. Перед долгим запуском сообщите поддержке по адресу hi@laozhang.ai ожидаемую пиковую параллельность, дневной объём и размеры входных изображений, чтобы подтвердить мощность.

Ошибки и оплата

  • Lite поддерживает только 1K. Не передавайте 512, 2K или 4K; для других размеров используйте Nano Banana 2.1, Nano Banana 2 или Pro.
  • Пишите размеры с заглавной K. Значения в нижнем регистре, например 1k, Google отклоняет.
  • Запрос может вернуть HTTP 200 без изображения, например если промпт не просит изображение или проверка безопасности блокирует результат. Он тарифицируется как один вызов, поэтому измените промпт или изображение, прежде чем отправлять снова; см. раздел «Как не платить за пустые ответы» в обзоре Nano Banana.
  • HTTP 401 означает неверный ключ или заголовок Authorization: Bearer. Ответы 429 и 5xx повторяйте с нарастающей задержкой.

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

Может ли Lite выдавать 2K или 4K и использовать поиск Google?

Нет, ни то ни другое: Lite выдаёт только 1K и не поддерживает привязку к поиску. Все три модели ниже принимают те же запросы, поэтому достаточно сменить ID модели:
  • gemini-nano-banana-2.1 (Nano Banana 2.1, $0.045 за вызов) — для размеров от 1K до 4K
  • gemini-3.1-flash-image (Nano Banana 2) — если нужны ещё 512px, 14 соотношений сторон или привязка к веб-поиску и поиску изображений
  • gemini-3-pro-image (Nano Banana Pro) — для сложных макетов от 1K до 4K с привязкой к веб-поиску

Подходит ли Lite для композиций и серий с одним персонажем?

Не очень. Lite принимает до 14 изображений объектов, но в таблице референсов Google для неё нет референсов персонажей и стиля, а сам Google отмечает, что модель не оптимизирована для нескольких референсов и последовательной многошаговой правки. Lite справляется с локальными правками одного изображения, например со сменой цвета или фона. Чтобы объединить несколько изображений в одно или сохранить внешность человека в серии, используйте Nano Banana 2.1 или Nano Banana 2: они принимают до 10 изображений объектов и 4 изображений персонажей.

Является ли gemini-3.1-flash-lite-image стабильным ID модели?

Да. На странице модели Google она указана как стабильная версия, без суффикса -preview. Используйте ID ровно в таком написании.

Можно ли запускать Lite с высокой параллельностью?

Да, платформа не ограничивает параллельность. Перед запуском настройте повторы и таймауты по разделу «Lite под высокой нагрузкой» и сообщите поддержке ожидаемый пик, чтобы подтвердить мощность апстрима.

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