Для API-интеграции Nano Banana лучше мыслить не рейтингом моделей, а маршрутом запроса. Базовая точка для новых задач - Nano Banana 2 (gemini-3.1-flash-image-preview): она закрывает диапазон от 0.5K до 4K, стоит заметно дешевле Pro и подходит для большинства продуктовых, контентных и рабочих изображений. Original Nano Banana (gemini-2.5-flash-image) остается дешевой линией для простых 1024px-задач, а Nano Banana Pro (gemini-3-pro-image-preview) нужен там, где текст, схема, макет или финальная полировка стоят дороже разницы в цене.
Быстрая схема выбора:
| API-маршрут | Официальный model ID | Цена и граница разрешения | Когда использовать | Когда не использовать |
|---|---|---|---|---|
| Original Nano Banana | gemini-2.5-flash-image | Около $0.039 за 1024px-изображение | Простое, дешевое, низкорисковое 1K-изображение или стабильный старый пайплайн. | Нужны читаемый текст, 2K/4K, сложная структура или финальная проверка. |
| Nano Banana 2 | gemini-3.1-flash-image-preview | $0.045 за 0.5K, $0.067 за 1K, $0.101 за 2K, $0.151 за 4K | Основной маршрут для новых API-задач генерации изображений. | Один плохой результат создает дорогую ручную проверку или правку. |
| Nano Banana Pro | gemini-3-pro-image-preview | $0.134 за 1K/2K, $0.24 за 4K | Текст, диаграммы, плотная верстка, брендовые материалы, клиентские или финальные ассеты. | Черновики, внутренние превью, массовые простые миниатюры. |
Цены и preview-статусы в таблице сверены с документацией Google AI на 20 апреля 2026 года; лимиты проекта, доступность и права аккаунта нужно проверять в текущем Google Console или AI Studio.
Три маршрута API - не три названия одной модели
Nano Banana часто звучит как общее имя семейства, но рабочий API не может маршрутизировать запросы по семейному прозвищу. Интеграции нужны четыре вещи: model ID, требуемое разрешение, ценовая линия и причина переключения. Вопрос "что лучше" слишком широкий; для продакшена важнее вопрос "что будет, если этот конкретный результат окажется плохим".
Если в прайс-листе или интерфейсе встречается Standard, не превращайте это слово в model ID. Оно может описывать режим цены Google, но запрос в коде все равно должен разрешаться в gemini-2.5-flash-image, gemini-3.1-flash-image-preview или gemini-3-pro-image-preview.
Original Nano Banana - низкозатратная базовая линия. Она полезна для простых квадратных изображений, внутренних заглушек, старых промптов, массовых черновиков и задач, где не страшно перегенерировать картинку. Делать ее основным маршрутом для нового продукта рискованно: она не решает задачи 2K/4K, надежного текста и сложной композиции.
Nano Banana 2 - основной маршрут. У нее самый удобный диапазон размеров, от 0.5K для быстрых превью до 4K для более крупных материалов. Это делает модель естественным выбором для SaaS-функций, блоговых иллюстраций, справочных материалов, товарных концептов, локализованных изображений и веб-графики.
Nano Banana Pro - премиальный маршрут. Его смысл не в том, чтобы заменить все остальные модели, а в том, чтобы уменьшить дорогие ошибки: нечитаемый текст, сломанная диаграмма, неудачная компоновка, брендовый ассет, который не пройдет проверку, или клиентский материал, который придется вручную исправлять.
Цена и разрешение меняют решение
Сравнивать модели только по цене одного 1K-изображения недостаточно. Original дешевле всех в своей 1024px-роли, Nano Banana 2 дает самую гибкую лестницу размеров, а Pro стоит дороже из-за более ответственного назначения. Разрешение - часть маршрута, а не сноска.
Текущие ценовые строки Google, сверенные 20 апреля 2026 года:
| Маршрут | Standard image price | Batch/Flex, где доступно | Практический смысл |
|---|---|---|---|
Original Nano Banana (gemini-2.5-flash-image) | Около $0.039 за 1024px | Около $0.0195 через Batch | Самый дешевый путь для простых 1K-изображений. |
Nano Banana 2 (gemini-3.1-flash-image-preview) | $0.045 за 0.5K, $0.067 за 1K, $0.101 за 2K, $0.151 за 4K | Обычно около половины Standard в асинхронных режимах | Лучший маршрут по умолчанию, когда нужны размеры и современное качество без Pro-стоимости. |
Nano Banana Pro (gemini-3-pro-image-preview) | $0.134 за 1K/2K, $0.24 за 4K | $0.067 за 1K/2K, $0.12 за 4K | Подходит, когда один плохой результат создает дорогую ручную работу. |
Первая практическая проверка - где изображение будет использоваться. Миниатюре или внутреннему черновику часто не нужен Pro; 4K-материалу нельзя оставаться на Original; текстовая схема может быть дешевле на Pro, если альтернативой становится несколько попыток и ручная правка.
Вторая проверка - цена ошибки. Дешевая модель становится дорогой, если она генерирует несколько непригодных результатов подряд. Дорогая модель может быть экономной, если она сразу дает материал, который проходит редактора, дизайнера или клиента. Для несрочных объемных задач асинхронные режимы могут дополнительно изменить выбор: Pro или 4K Nano Banana 2 становятся заметно доступнее, если картинка не нужна прямо сейчас.
Начинайте с Nano Banana 2 и добавляйте два исключения
Самое устойчивое правило для нового API - не "всегда брать самую новую модель", а "Nano Banana 2 по умолчанию, Original для дешевого исключения, Pro для качественного исключения". Так продукт получает один центр тяжести, а стоимость остается управляемой.
Nano Banana 2 подходит для обычной генерации: изображения к статьям, продуктовые концепты, иллюстрации в приложении, легкие социальные карточки, справочные визуалы, локализованные картинки и веб-графика, где может понадобиться больше 1024px. Она достаточно сильна для основного потока и не делает Pro базовой ценой.
Original Nano Banana стоит включать только при совпадении условий: 1K достаточно, важного текста нет, композиция простая, ошибка не влечет дорогую проверку, а стоимость важнее качества. Это хороший путь для старых задач, внутренних плейсхолдеров, массовых низкорисковых вариантов и простых миниатюр.
Nano Banana Pro нужен, когда запрос содержит текст, диаграмму, плотный макет, несколько ограниченных объектов, брендовые элементы или финальный ассет. Pro также полезен как первый выбор для оплачиваемой рекламы, клиентских материалов, документационных схем и продуктовых страниц, где один плохой результат дороже ценовой разницы.
В продакшене сначала классифицируйте запрос
Менять model ID в коде легко; объяснить хаотичную смену моделей сложнее. Маршрутизатор должен сначала классифицировать задачу, затем выбрать модель, а затем проверить результат именно по причине выбора.
Рабочий порядок может выглядеть так:
- Новый трафик генерации изображений отправляется в Nano Banana 2.
- Запрос до генерации повышается до Pro, если есть текст, схема, жесткая верстка, финальный ассет или брендовый риск.
- Запрос понижается до Original только если он простой, 1K, низкорисковый и чувствительный к стоимости.
- Несрочные массовые задачи уходят в Batch/Flex.
- Результат проверяется по причине выбора: текст для Pro, размер и достаточное качество для Nano Banana 2, дешевое 1K-воспроизведение для Original.
Отдельно держите лимиты и ретраи. Событие 429 или ограничение проекта не должно автоматически отправлять запрос в Pro. Это операционная ветка, а не творческая. После выбора модели уже можно планировать квоты и поведение при лимитах через руководство по лимитам Gemini API.
В коде выбирайте model ID, а не ярлык
Безопасный паттерн - использовать внутренние названия маршрутов и хранить привязку к официальным model ID в одном месте. Текст кнопки, название тарифа или alias провайдера не должны становиться значением, которое уходит в API.
pythonfrom google import genai from google.genai import types client = genai.Client(api_key="GEMINI_API_KEY") MODEL_BY_ROUTE = { "cheap_1k": "gemini-2.5-flash-image", "default": "gemini-3.1-flash-image-preview", "premium": "gemini-3-pro-image-preview", } def choose_image_route(job): if job.get("final_asset") or job.get("has_text") or job.get("diagram"): return "premium" if job.get("simple") and job.get("max_size") == "1k" and job.get("low_risk"): return "cheap_1k" return "default" job = { "prompt": "Create a clean product release diagram with readable labels", "has_text": True, "diagram": True, "final_asset": False, } route = choose_image_route(job) response = client.models.generate_content( model=MODEL_BY_ROUTE[route], contents=job["prompt"], config=types.GenerateContentConfig(response_modalities=["IMAGE"]), )
Параметры, специфичные для модели, применяйте после выбора маршрута. Если размер или настройка поддерживается только частью моделей, не передавайте ее всем fallback-веткам. Логируйте route, официальный model ID, размер, ценовую линию, триггер повышения и результат проверки - это дает объяснимую стоимость и нормальную отладку.
Когда мигрировать существующий пайплайн
Если старый пайплайн на Original Nano Banana стабильно дает приемлемые простые изображения, не нужно переносить его только из-за появления новой модели. Сначала протестируйте реальные prompts, сравните долю принятых результатов, время ручной правки, число повторов и итоговую стоимость.
Переносите default на Nano Banana 2, когда нужны большие размеры, более сильное следование инструкциям или единый маршрут для разных задач. Делайте это поэтапно: небольшая доля трафика, сравнение accepted-output rate, сравнение ручного ремонта, затем изменение default.
Повышайте отдельные задачи до Pro, когда Nano Banana 2 предсказуемо не справляется: текст ломается, структура диаграммы неверна, брендовая картинка не проходит проверку, финальный ассет требует ручной доработки. Подробное двухмодельное сравнение default и premium линий доступно в Nano Banana Pro vs Nano Banana 2.
Часто задаваемые вопросы
Что выбрать по умолчанию для новой интеграции?
Nano Banana 2, то есть gemini-3.1-flash-image-preview. Это наиболее сбалансированный маршрут по возможностям, размерам и цене. Original добавляйте как дешевое 1K-исключение, Pro - как премиальное исключение.
Когда Nano Banana Pro оправдывает цену?
Когда изображение должно содержать читаемый текст, схему, плотную верстку, брендовый визуал, клиентский материал или финальный ассет. Если один плохой результат создает ручную правку или риск публикации, Pro часто дешевле в общей стоимости.
Original Nano Banana еще нужен?
Да, но в узкой роли. Он подходит для простых, низкорисковых, 1024px-изображений, где стоимость важнее точности текста и финальной полировки. Для новых смешанных потоков с разными размерами лучше не делать его default.
Цены в таблице являются квотой или гарантией аккаунта?
Нет. Это ценовые строки Google API, сверенные 20 апреля 2026 года. Квоты проекта, eligibility, rate limits и доступность могут отличаться в зависимости от аккаунта и биллинга, поэтому перед продакшеном проверяйте текущий проект в Google Console или AI Studio.
Можно ли переключить модель без переписывания всего пайплайна?
Обычно да, если модель, размер, prompt и проверка результата уже разделены. Надежный роутер хранит route, model ID, размер, ценовую линию и правило проверки вместе; тогда миграция меняет маршрутизацию, а не всю систему генерации.