Gemini 3.1 Flash Image (Nano Banana 2): полное руководство по API

Gemini 3.1 Flash Image (кодовое название Nano Banana 2) -- новейшая модель генерации изображений от Google, выпущенная 26 февраля 2026 года. Благодаря скорости Flash-уровня (4-6 секунд) и качеству изображений, близкому к Pro, она мгновенно заняла первое место в рейтинге Chatbot Arena Image. В этом руководстве мы рассмотрим всё -- от подключения API и анализа цен до решений для прокси-доступа и лучших практик для продакшена. Официальная цена за изображение 1K составляет $0.067, а через прокси-платформу -- всего $0.03 (Google AI, проверено 2026-03-08).

Что такое Gemini 3.1 Flash Image (Nano Banana 2)

26 февраля 2026 года Google официально представила Gemini 3.1 Flash Image Preview с внутренним кодовым названием Nano Banana 2 (сокращённо NB2). Это название продолжает фруктовую традицию команды Google AI -- предыдущая модель Gemini 3 Pro Image носила кодовое имя Nano Banana Pro. Позиционирование NB2 предельно чёткое: обеспечить качество генерации изображений, близкое к Pro-уровню, при скорости и стоимости Flash. Для большинства коммерческих сценариев это означает, что вы получаете практически идентичный визуальный результат менее чем за половину цены, а скорость генерации при этом почти вдвое выше.

С точки зрения технической архитектуры, NB2 построена на мультимодальных возможностях модели Gemini 3.1 Flash. Идентификатор модели -- gemini-3.1-flash-image-preview. Это не отдельная модель генерации изображений, а мультимодальная модель, способная одновременно понимать текст и изображения и нативно генерировать картинки. Это значит, что в одном API-вызове можно вести текстовый диалог и генерировать изображения без переключения между различными эндпоинтами. Такой «нативно мультимодальный» подход позволяет NB2 достигать точности рендеринга текста около 90%, что значительно превосходит традиционные модели генерации изображений.

В экосистеме Gemini NB2 играет роль «короля соотношения цена/качество». Если ранее вы использовали Nano Banana Pro (Gemini 3 Pro Image) для генерации изображений, NB2 предлагает более экономичную альтернативу: выше скорость, ниже стоимость, а разница в качестве в большинстве сценариев практически незаметна. Google чётко определяет позиционирование: NB2 подходит для пакетной обработки, быстрых итераций и сценариев, чувствительных к стоимости, тогда как Pro ориентирована на профессиональных пользователей с максимальными требованиями к детализации и качеству. Для подавляющего большинства разработчиков NB2 -- именно та модель, которая вам нужна.

Ключевые характеристики Nano Banana 2 и сравнение с Pro

Выбор между NB2 и Nano Banana Pro -- первое решение, с которым сталкиваются многие разработчики. Вместо перечисления функций давайте обратимся к данным -- ниже представлено количественное сравнение на основе официальной документации Google и реальных тестов (Google AI, проверено 2026-03-08).

По скорости генерации преимущество NB2 очевидно. Для создания одного изображения разрешением 1K NB2 требуется в среднем 4-6 секунд, тогда как Pro -- обычно 8-12 секунд. Эта разница многократно усиливается при пакетной генерации: если вам нужно сгенерировать 100 изображений за раз, NB2 сэкономит более 10 минут ожидания. По стоимости одно изображение 1K у NB2 обходится в $0.067, тогда как Pro при том же разрешении -- $0.134, ровно вдвое дороже.

Точность рендеринга текста -- один из ключевых показателей качества модели генерации изображений. У NB2 этот показатель составляет около 90%, что означает корректное отображение текста в большинстве постеров, изображений для социальных сетей и демонстрационных материалов. У Pro точность чуть выше -- около 94%, но на практике эти 4% разницы заметны лишь при мелком шрифте или сложной вёрстке. Если ваше приложение не требует детальной типографики, возможностей NB2 более чем достаточно.

Между моделями есть и другие различия, заслуживающие внимания. NB2 поддерживает более 15 соотношений сторон -- от классических 1:1, 16:9 до вертикальных 9:16, тогда как Pro в основном ограничена стандартными пропорциями. В плане поисковой интеграции NB2 одновременно поддерживает веб-поиск и поиск изображений (Google Search grounding), а Pro -- только веб-поиск. Обе модели принимают до 14 референсных изображений на входе и поддерживают максимальное разрешение 4K (4096px). В рейтинге Chatbot Arena NB2 занимает первое место в категории Text-to-Image, а Pro входит в TOP 3.

Рекомендация по выбору проста: если вам важны скорость, низкая стоимость и пакетная обработка -- выбирайте NB2; если вам нужна максимальная точность рендеринга текста или высочайшее качество рекламных материалов и продуктовой фотографии -- выбирайте Pro. Для более чем 80% сценариев использования NB2 будет лучшим выбором. Более детальное сравнение доступно в нашей статье -- Подробное сравнение Nano Banana 2 и Pro.

Глубокий анализ цен и расходов

Понимание ценообразования NB2 -- первый шаг к контролю расходов. В отличие от традиционной поштучной оплаты, Gemini Flash Image использует модель оплаты по токенам: входные и выходные данные тарифицируются отдельно по количеству токенов, а количество токенов на выходе зависит от разрешения изображения. На первый взгляд это может показаться сложным, но разобравшись, вы сможете точно прогнозировать стоимость каждого вызова (Google AI, проверено 2026-03-08).

Механизм оплаты по токенам

Тарификация NB2 состоит из трёх компонентов: входные токены ($0.50/млн токенов), текстовые выходные токены ($3.00/млн токенов) и токены изображений на выходе ($60.00/млн токенов). Цена токенов изображений в 20 раз выше текстовых -- именно поэтому основная стоимость генерации приходится на выходные данные. Изображения разного разрешения потребляют различное количество токенов: 512px -- 747 токенов, 1024px -- 1120 токенов, 2048px -- 1680 токенов, 4096px -- 2520 токенов.

Пересчитав эти цифры в реальную стоимость за изображение, получаем данные, представленные в таблице ниже. Обратите внимание, что здесь учитываются только токены вывода изображений -- входной промпт обычно составляет от нескольких десятков до нескольких сотен токенов, и его стоимость можно не учитывать.

Как видно из таблицы, Google предлагает скидку 50% при использовании пакетного API (Batch API). Если вашему сценарию не требуется мгновенный отклик -- например, ежедневная пакетная генерация маркетинговых изображений -- пакетный режим является наиболее выгодным через официальный канал. Однако он предполагает задержку обработки и не подходит для интерактивных сценариев.

Для разработчиков, которым важна экономия, прокси-платформы предлагают конкурентное ценовое решение. Например, laozhang.ai предлагает единую стоимость $0.03 за изображение любого разрешения. Для низких разрешений это сопоставимо с официальной ценой, но при высоких разрешениях преимущество огромно -- изображение 4K обходится примерно на 80% дешевле. Подробное сравнение тарифов доступно в нашем руководстве Полное руководство по ценам Gemini Flash Image.

Стратегии оптимизации расходов

В реальных проектах есть несколько проверенных стратегий для эффективного контроля затрат. Во-первых, стратегия выбора разрешения: если изображения предназначены для социальных сетей или веб-отображения (обычно не более 1200px), достаточно выбрать разрешение 1K -- для большинства экранов визуальное качество будет достаточным. Во-вторых, мультимодальные возможности NB2 позволяют в рамках одного диалога последовательно генерировать несколько изображений, повторно используя токены контекста и снижая расходы на промпт. Наконец, для неинтерактивных сценариев рекомендуется использовать пакетный API -- при том же качестве стоимость снижается вдвое. Информация о бесплатном доступе доступна в нашей статье Бесплатный API Gemini 3.1 Flash Image.

Практическое руководство по подключению API (5 минут)

Подключить API NB2 очень просто -- вам нужен API-ключ Google AI, после чего отправляйте запросы через стандартный Gemini API. Весь процесс занимает не более 5 минут. Ниже показаны примеры на Python, Node.js и curl.

Получение API-ключа

Для начала перейдите в Google AI Studio и создайте API-ключ. Войдите в аккаунт Google, нажмите «Get API key» в левом меню и выберите «Create API key in new project». Обратите внимание: NB2 находится на стадии Preview, бесплатный уровень пока недоступен -- для вызовов необходимо подключить платный тариф Gemini API. Полученный ключ будет иметь формат AIzaSy... -- сохраните его в надёжном месте.

Пример на Python

Python -- наиболее популярный способ подключения. С официальным SDK google-genai для генерации изображения достаточно нескольких строк кода. Ниже -- полный рабочий пример с сохранением изображения и обработкой ошибок:

python
import os
import base64
from google import genai


client = genai.Client(api_key=os.environ.get("GEMINI_API_KEY"))

# Генерация изображения
response = client.models.generate_content(
    model="gemini-3.1-flash-image-preview",
    contents="Рыжий кот сидит на подоконнике и смотрит на закат, акварельный стиль",
    config=genai.types.GenerateContentConfig(
        response_modalities=["TEXT", "IMAGE"],  # Возвращать текст и изображение
    ),
)

# Обработка ответа
for part in response.candidates[0].content.parts:
    if part.inline_data:  # Данные изображения
        image_bytes = base64.b64decode(part.inline_data.data)
        with open("output.png", "wb") as f:
            f.write(image_bytes)
        print(f"Изображение сохранено, формат: {part.inline_data.mime_type}")
    elif part.text:  # Текстовое описание
        print(f"Ответ модели: {part.text}")

Ключевой параметр здесь -- response_modalities=["TEXT", "IMAGE"], который указывает модели возвращать одновременно текст и изображение. Если нужно только изображение, установите ["IMAGE"]. Данные изображения в ответе возвращаются в формате base64-кодированного PNG -- декодируйте и сохраните.

Пример на Node.js

Для проектов на Node.js используйте официальный SDK @google/genai. Ниже -- эквивалентная реализация:

javascript
import { GoogleGenAI } from "@google/genai";
import fs from "fs";

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

async function generateImage() {
  const response = await ai.models.generateContent({
    model: "gemini-3.1-flash-image-preview",
    contents: "Рыжий кот сидит на подоконнике и смотрит на закат, акварельный стиль",
    config: { responseModalities: ["TEXT", "IMAGE"] },
  });

  for (const part of response.candidates[0].content.parts) {
    if (part.inlineData) {
      const buffer = Buffer.from(part.inlineData.data, "base64");
      fs.writeFileSync("output.png", buffer);
      console.log(`Изображение сохранено, формат: ${part.inlineData.mimeType}`);
    } else if (part.text) {
      console.log(`Ответ модели: ${part.text}`);
    }
  }
}

generateImage().catch(console.error);

Команда curl

Для быстрого тестирования или интеграции в shell-скрипты curl -- самый прямой способ. Следующая команда отправит запрос и сохранит полученное изображение локально:

bash
curl -s "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent?key=${GEMINI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Рыжий кот сидит на подоконнике и смотрит на закат, акварельный стиль"}]}],
    "generationConfig": {"responseModalities": ["TEXT", "IMAGE"]}
  }' | python3 -c "
import sys, json, base64
data = json.load(sys.stdin)
for part in data['candidates'][0]['content']['parts']:
    if 'inlineData' in part:
        with open('output.png', 'wb') as f:
            f.write(base64.b64decode(part['inlineData']['data']))
        print('Изображение сохранено как output.png')
"

Логика вызова во всех трёх способах идентична: отправка текстового промпта, получение JSON-ответа с данными изображения. Выбор зависит от вашего технического стека. Стоит отметить, что NB2 поддерживает передачу референсных изображений в промпте для редактирования, переноса стиля и других продвинутых функций -- подробнее об этом в разделе о расширенных возможностях.

Решения для доступа через прокси

Для разработчиков за пределами регионов, где Google API доступен напрямую, существуют сетевые ограничения при обращении к серверам Google. В настоящее время есть три основных решения: прямое подключение (требует VPN), прокси-платформа и собственный прокси-сервер. Каждый вариант имеет свои преимущества и недостатки, подходящие для различных сценариев и уровней технической подготовки.

Вариант 1: Прямое подключение к Google API

Прямое подключение -- самый непосредственный способ: вызов generativelanguage.googleapis.com напрямую с сервера с доступом к глобальной сети. Преимущества: минимальная цена (официальные тарифы Google), минимальная задержка, данные не проходят через третьи стороны. Недостатки очевидны: необходим зарубежный сервер или стабильный VPN, для оплаты требуется международная кредитная карта, а нестабильность сети может приводить к таймаутам запросов. Если у вашей команды уже есть серверная инфраструктура за рубежом или вы индивидуальный разработчик со стабильным VPN-решением, прямое подключение будет наиболее экономичным.

Вариант 2: Прокси-платформа (рекомендуется)

Прокси-платформа -- наиболее популярное решение. Такие платформы размещают серверы за рубежом и проксируют запросы к Google API для локальных пользователей, предоставляя при этом удобные способы оплаты и техническую поддержку. Например, с laozhang.ai подключение предельно простое: достаточно заменить base URL API с официального адреса Google на адрес прокси, остальной код остаётся без изменений.

Пример подключения к NB2 через laozhang.ai на Python:

python
from openai import OpenAI

# Вызов в формате, совместимом с OpenAI
client = OpenAI(
    api_key="your-laozhang-api-key",  # Получите на laozhang.ai
    base_url="https://api.laozhang.ai/v1"
)

response = client.chat.completions.create(
    model="gemini-3.1-flash-image-preview",
    messages=[
        {"role": "user", "content": "Рыжий кот сидит на подоконнике и смотрит на закат, акварельный стиль"}
    ],
)
print(response.choices[0].message.content)

Ключевое преимущество прокси-платформы -- подключение без дополнительной настройки: не нужен VPN, не нужна международная кредитная карта, не нужно настраивать инфраструктуру. А благодаря поддержке формата, совместимого с OpenAI, если ваш проект уже интегрирован с OpenAI SDK, достаточно изменить одну строку с base URL для перехода на NB2. По цене laozhang.ai предлагает единый тариф $0.03 за изображение любого разрешения, что при 2K и 4K на 50-80% дешевле официальных цен. Подробное сравнение прокси-каналов доступно в статье Самый дешёвый канал API Gemini Flash Image.

Вариант 3: Собственный прокси-сервер

Собственный прокси подходит корпоративным пользователям со строгими требованиями к конфиденциальности данных. Решение заключается в аренде облачного сервера за рубежом (например, в Сингапуре или Японии), развёртывании обратного прокси Nginx и перенаправлении запросов на Google API. Таким образом данные проходят только через ваш сервер, минуя третьи стороны. Стоимость: расходы на сервер (обычно $5-20/мес.), нагрузка по администрированию и возможный риск блокировки IP.

Для большинства разработчиков прокси-платформа обеспечивает оптимальный баланс между удобством, стоимостью и стабильностью. При объёме вызовов от нескольких тысяч до десятков тысяч в месяц прокси-платформа -- практически оптимальный выбор. При миллионных объёмах можно рассмотреть собственный прокси для дальнейшего снижения стоимости каждого вызова. Подробнее о решениях для прокси-доступа -- в нашей статье Полное руководство по прокси Gemini API.

Лучшие практики для продакшена

Переход от демо к продакшену часто определяется не самим вызовом API, а «окружающими» способностями: обработка ошибок, управление параллелизмом и мониторинг расходов. Ниже представлены лучшие практики, проверенные на реальных проектах, которые помогут построить стабильный и надёжный сервис генерации изображений.

Обработка ошибок и стратегия повторных запросов

API NB2 может возвращать различные типы ошибок: 429 (превышение лимита), 500 (внутренняя ошибка сервера), 503 (сервис недоступен). Для таких повторяемых ошибок рекомендуется использовать стратегию экспоненциального отступа -- после первой неудачи ждать 1 секунду, после второй -- 2 секунды, после третьей -- 4 секунды, максимум 3 попытки. Для неповторяемых ошибок, таких как 400 (ошибка формата запроса) или 403 (ошибка аутентификации), следует немедленно генерировать исключение. Ниже -- практичная обёртка для повторных запросов:

python
import time
import random

def generate_with_retry(client, prompt, max_retries=3):
    """Генерация изображения с экспоненциальным отступом"""
    for attempt in range(max_retries):
        try:
            response = client.models.generate_content(
                model="gemini-3.1-flash-image-preview",
                contents=prompt,
                config={"response_modalities": ["TEXT", "IMAGE"]},
            )
            return response
        except Exception as e:
            error_code = getattr(e, 'code', None)
            if error_code in [400, 403, 404]:
                raise  # Неповторяемая ошибка
            if attempt < max_retries - 1:
                wait = (2 ** attempt) + random.uniform(0, 1)
                print(f"Запрос не удался, повтор через {wait:.1f}с... ({e})")
                time.sleep(wait)
            else:
                raise  # Попытки исчерпаны

Управление параллелизмом

API NB2 имеет ограничение по частоте запросов: платные аккаунты обычно допускают 60-200 запросов в минуту (в зависимости от уровня квоты). При пакетной генерации без контроля параллелизма легко получить ошибку 429. Рекомендуется использовать семафоры (Semaphore) для ограничения параллельных запросов. Для Python asyncio оптимальное значение параллелизма -- 10-20: это позволяет эффективно использовать квоту, не провоцируя частые блокировки.

Также рекомендуется добавлять короткий период охлаждения (1-2 секунды) после каждого пакета задач, давая счётчику частоты API время на сброс. Это стабильнее стратегии «исчерпать квоту и ждать следующую минуту» и обеспечивает более равномерное время отклика. Для высоконагруженных сценариев обратитесь к нашему обзору Стабильные каналы генерации изображений Gemini.

Мониторинг расходов

Для приложений промышленного уровня рекомендуется после каждого вызова API записывать количество потреблённых токенов и устанавливать дневной лимит бюджета. Ответ NB2 содержит поле usage_metadata с подробными данными prompt_token_count и candidates_token_count. Записывая эти данные в базу данных или отправляя в систему мониторинга (например, Prometheus/Grafana), можно отслеживать тенденции расходов в реальном времени. Простой, но эффективный подход: задать дневной бюджет, при достижении 80% порога отправлять уведомление, при 100% -- автоматически приостанавливать новые запросы. Это надёжно защищает от неконтролируемых расходов из-за багов или аномального трафика.

Продвинутые функции и практические приёмы

NB2 -- не просто инструмент «текст в изображение». Модель поддерживает референсные изображения, поисковое дополнение, режим рассуждения и другие продвинутые функции, освоение которых открывает широкий спектр практических сценариев.

Референсные изображения (Image Reference)

NB2 принимает до 14 референсных изображений в одном промпте. Эта возможность существенно упрощает редактирование изображений, перенос стиля и поддержание единого бренда. Например, вы можете загрузить фотографию продукта и попросить NB2 «преобразовать в акварельный стиль» или «заменить фон на пляжную сцену». Референсные изображения передаются в base64-кодировке в поле inline_data вместе с текстовым промптом. На практике лучшие результаты достигаются при 1-3 референсных изображениях -- слишком большое количество может «запутать» модель.

Особенно практичный сценарий -- генерация брендированных материалов: загрузите логотип и стандарты цвета бренда, а затем попросите NB2 на их основе генерировать маркетинговые изображения для различных сцен, обеспечивая визуальное единство стиля. Это крайне ценно для электронной коммерции и SMM -- работа, ранее требовавшая ручного труда дизайнера, теперь может быть автоматизирована через API.

Google Search Grounding

NB2 уникально поддерживает функцию Google Search grounding, охватывающую как веб-поиск, так и поиск изображений. Проще говоря, вы можете попросить NB2 перед генерацией изображения сначала найти актуальную информацию в интернете и создать картинку на её основе. Например, промпт «создай иллюстрацию подходящего занятия на свежем воздухе, исходя из сегодняшней погоды» -- NB2 сначала найдёт текущую погоду, а затем сгенерирует соответствующую иллюстрацию. Эта функция особенно полезна при создании контента, привязанного к текущим событиям.

Стратегия выбора разрешения и соотношения сторон

NB2 поддерживает 4 варианта разрешения (512px, 1K, 2K, 4K) и более 15 комбинаций соотношений сторон. При выборе учитываются два фактора: конечное применение и стоимость. Для обложек в социальных сетях (обычно 16:9) разрешения 1K достаточно для большинства платформ; для печатной продукции или крупных баннеров рекомендуется 2K или 4K; для миниатюр или аватаров хватит 512px. NB2 автоматически выбирает ближайшее поддерживаемое соотношение сторон -- если вы запросите нестандартную пропорцию (например, 2.35:1), модель интеллектуально подберёт ближайший доступный вариант. В промпте можно указать соотношение сторон через «aspect ratio 16:9».

Режим рассуждения (Thinking Mode)

NB2 также поддерживает режим рассуждения (thinking) с уровнями minimal и high. При его активации модель перед генерацией изображения выполняет анализ промпта, планирует композицию и выбирает цветовую схему. Это добавляет незначительную задержку (около 1-2 секунд), но в сложных сценариях заметно повышает качество. Рекомендуется использовать режим high для точной композиции (например, «персонаж стоит в левой трети кадра») или сложных сцен (например, «городской силуэт на закате отражается в озере»), а для простых сценариев -- minimal или без рассуждения.

Часто задаваемые вопросы и заключение

Что выбрать: NB2 или Nano Banana Pro? Если важны соотношение цена/качество, скорость и пакетная обработка -- выбирайте NB2; если нужны максимальное качество рекламных материалов и точный рендеринг текста -- выбирайте Pro. Для более чем 80% сценариев NB2 будет лучшим выбором.

Можно ли вызывать API NB2 напрямую из регионов с ограниченным доступом? Прямой вызов Google API может быть недоступен. Рекомендуется использовать прокси-платформу (например, laozhang.ai) -- достаточно заменить base URL. Документация API: docs.laozhang.ai.

Есть ли у NB2 бесплатный тариф? Согласно данным Google AI (проверено 2026-03-08), бесплатный уровень NB2 отображается как «недоступен». Для использования необходимо подключить платный тариф Gemini API.

Что делать, если генерация изображения не удалась? Распространённые причины: промпт срабатывает фильтр безопасности (скорректируйте формулировку), таймаут запроса (проверьте сеть или используйте прокси), превышение лимита частоты (снизьте параллелизм или подождите перед повтором).

Поддерживает ли NB2 генерацию изображений с текстом на кириллице? Да. Точность рендеринга текста NB2 составляет около 90%, и это распространяется на кириллицу. Рекомендуется в промпте явно указывать размер шрифта и расположение текста для лучших результатов.

Заключение и руководство к действию: Gemini 3.1 Flash Image (Nano Banana 2) со скоростью Flash, качеством, близким к Pro, и конкурентоспособной ценой стала самой перспективной моделью генерации ИИ-изображений 2026 года. Для разработчиков подключение через прокси-платформу -- простейший и эффективнейший путь: одна строка кода -- и вы готовы к работе. Будь то быстрое прототипирование, пакетная генерация маркетинговых материалов или построение промышленного сервиса генерации изображений -- NB2 обеспечит надёжную поддержку. Начните подключение прямо сейчас: 5 минут настройки -- и в вашем распоряжении мощный и экономичный инструмент ИИ-генерации изображений.