Skip to main content

​
Обзор

Nano Banana 2 (кодовое имя) — это новейшая модель генерации изображений Google, выпущенная 26 февраля 2026 года, с ID модели gemini-3.1-flash-image-preview. Она переосмысливает экономическую эффективность генерации изображений, обеспечивая качество уровня Pro при скорости и стоимости уровня Flash, что делает её новейшим флагманом серии Nano Banana.
🔥 Выпущена 26 февраля 2026 года: Nano Banana 2 уже доступна! Качество уровня Pro, скорость уровня Flash, тарификация на основе token всего до 36% от цен Google! 512px всего за $0.025/image! Поддерживает вывод 4K, 14 соотношений сторон, Image Search Grounding и другие эксклюзивные функции.
🆕 Обновление от 29 мая 2026 года (-preview снят): Google обновила официальную документацию и выпустила стабильное название модели gemini-3.1-flash-image (без -preview). APIYI уже поддерживает его.
  • Старое название по-прежнему работает: gemini-3.1-flash-image-preview продолжает работать как обычно, тарификация без изменений, изменения кода не нужны.
  • Оба названия работают: используйте либо новое gemini-3.1-flash-image, либо оригинальное название -preview.
Обратите внимание: Google пока не уточнила, отличается ли стабильная версия от предварительной версии по качеству вывода, фильтрации безопасности или другому поведению. Будем рады, если вы протестируете и поделитесь отзывом.
Все API для изображений являются синхронными — здесь нет ID задачи для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Установите достаточно большой таймаут для этой модели; см. Основы и лучшие практики Image API.

API генерации изображений по тексту

Генерируйте изображения из текстовых prompt. Включает интерактивную песочницу для онлайн-тестирования.

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

Загрузите изображение + инструкции по редактированию, чтобы сгенерировать новые изображения. Включает интерактивную песочницу.

​
Пусть AI-агент выполнит интеграцию

Если вы работаете с Codex / Claude Code / Cursor, скопируйте prompt ниже и передайте его своему агенту. Сначала он получает plain-text версию этой страницы (добавьте .md к любому docs URL), затем пишет код в стеке вашего проекта — тайм-аут, защищённый разбор parts, сжатие при загрузке и параметры разрешения уже заложены в требования.

Пусть coding agent выполнит интеграцию или отладку Nano Banana 2 для генерации изображений по тексту и редактирования изображений. Скопируйте и вставьте это в Codex, Claude Code, Cursor и аналогичные инструменты.

​
Почему Nano Banana 2 от APIYI?

Nano Banana Pro / 2 — модель №1 по объему использования на APIYI — стабильная, надежная и быстрая. Если вы хотите работать с профессиональной командой, APIYI — правильный выбор. Только что выпущенный флагман Google по-прежнему ограничен по мощности на стороне источника — APIYI глубоко оптимизирует опыт по направлениям надежности, стоимости и интеграции:

Официальный канал · Как у Gemini

На 100% совместимо с нативным Gemini API Google (/v1beta/models/.../generateContent) и паттерном OpenAI SDK — тот же body запроса, те же поля ответа и коды ошибок. Миграция без кода.

Без ограничений на параллельные запросы

Не ограничено потолками RPM/RPD в Google AI Studio. Пакетная генерация enterprise-масштаба и пиковый трафик масштабируются линейно без прерываний из-за квоты.

28-36% от прайса Google

$0.055/image за вызов (против $0.151 у Google), 512px — от $0.025/image на основе token (против $0.045). Суммируйте с бонусами за пополнение, чтобы получить всего 30,3% от прайса.

Глобальный доступ без барьеров

Не требуется зарубежный сервер или proxy — подключайтесь напрямую к api.apiyi.com из материковых дата-центров, домашних сетей или зарубежных узлов. Стабильная задержка, без трансграничной переработки архитектуры.

Полная линейка моделей

Одна и та же серия охватывает Nano Banana Pro (максимальное качество), Nano Banana 2 (лучшее соотношение цены и качества) и классический Nano Banana — комбинируйте по сценарию.

Профессиональная корпоративная поддержка

Наша команда специализируется на production-развертываниях генерации изображений и обладает глубоким опытом в выборе модели, настройке и интеграции — сквозная поддержка от PoC до production.

​
Ключевые возможности

Качество профессионального уровня

Яркое освещение, богатые текстуры, чёткие детали — качество, сопоставимое с Nano Banana Pro, при гораздо более высокой скорости

Вывод в 4K Ultra-HD

Поддерживает разрешения 512px, 1K, 2K, 4K, до 4096×4096

14 соотношений сторон

Новые добавления: 1:4, 4:1, 1:8, 8:1 — всего 14 соотношений сторон, охватывающих больше сценариев использования

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

Эксклюзивно для Nano Banana 2 — извлекает визуальный контекст из Google Image Search

Точный рендеринг текста

Чёткий, разборчивый текст на изображениях с поддержкой нескольких языков — идеально для постеров и маркетинговых материалов

Многораундовое редактирование

Диалоговое редактирование изображений с итеративной доработкой в чате

Режим рассуждения

Настраиваемые минимальный или высокий уровни рассуждения для более точной обработки сложных prompt

Сохранение сходства

Сохраняет сходство до 5 персонажей и 14 опорных объектов

​
Сравнение версий

Руководство по выбору:
  • 🔥 Лучшее соотношение цены и качества → Nano Banana 2 (по token, от $0.025/image, качество уровня Pro + скорость уровня Flash)
  • 🎨 Максимальное качество → Nano Banana Pro ($0.09/image, наивысшая точность)
  • ⚡ Минимальная стоимость → Nano Banana ($0.025/image, быстрый и стабильный)

​
Цены

Выбор режима тарификации: Nano Banana 2 поддерживает два режима тарификации, которые выбираются через настройку «Billing model» при создании вашего API token:
  • Выберите Pay-as-you-go или Pay-as-you-go Priority → тарификация на основе token
  • Выберите Pay-per-request или Pay-per-request Priority → тарификация за вызов (так же, как у Nano Banana Pro)
  • ⚠️ НЕ выбирайте Hybrid billing

​
Тарификация за вызов

Enterprise HA Channel: NanoBananaEnterprise доступен по ставке, в 1.4 раза превышающей стандартную ставку Nano Banana Pro ($0.126/image), и предоставляет выделенный отказоустойчивый резервный вариант для enterprise-нагрузок.

​
Тарификация на основе token (только для Nano Banana 2)

​
Оценка цен при тарификации на основе token

💰 Тарификация на основе token позволяет сэкономить больше! При тарификации на основе token изображения 512px стоят всего $0.025 — это лишь 36% от цен Google! Для сценариев с низким разрешением это значительно дешевле, чем тарификация за вызов ($0.055/image). Для 4K цена на основе token (~$0.07) даже ниже, чем тарификация за вызов, и оба варианта намного дешевле официальной цены Google $0.151/image. В сочетании с бонусами за пополнение фактические затраты ещё ниже.

​
Три параметра, влияющих на тарификацию

Приведённые ниже цифры получены в ходе живого тестирования на рабочем шлюзе 2026-08-27 (12–20 прогонов на каждое условие, все значения основаны на фактических списаниях, зафиксированных в консоли, а не на оценках). Их влияние на ваш счёт различается на два порядка, поэтому оптимизируйте в указанном порядке.

​
thinkingLevel: значение по умолчанию уже минимальное, а high стоит ещё на половину дороже

gemini-3.1-flash-image поддерживает управление уровнем thinking (Pro — нет). Один и тот же prompt, по 20 прогонов на каждое значение:
  • Значение по умолчанию идентично minimal — статистически неотличимо (p=0.64), так что явная передача minimal ничего не даёт.
  • Только при high thoughtsTokenCount появляется как отдельное поле, и оно включается в completion_tokens и тарифицируется по тарифу генерации изображений.
  • Сложные prompt’ы начинают стоить дороже только после включения high: на уровне по умолчанию prompt из 3 tokens и prompt с рассуждением из 98 tokens не показали значимой разницы в числе output tokens (p=0.37); с high prompt с рассуждением использовал на 126% больше thinking tokens и стоил на 38% дороже за вызов.
Оставьте этот параметр без изменений для повседневной генерации. Включайте high только если у вас жёсткие требования к логике композиции, размещению текста в изображении или точности пропорций диаграммы — ценой +54% расходов и +55% задержки.

​
Привязка Google Search: работает, но тарифицируется за каждый поисковый запрос

Для изображений, которым нужна актуальная информация для корректности (карточки погоды, рыночные графики, афиши событий), подключите инструмент googleSearch. Привязка сработала во всех 12/12 прогонах.
Output tokens почти не меняются (−2.1% по сравнению с контрольной группой без инструмента после вычета стоимости поиска, статистически незначимо); вся стоимость приходится на сами поисковые вызовы — по $0.014 за каждый.
Модель сама решает, сколько поисков выполнять; заранее задать это нельзя. В тестах один запрос на изображение сам по себе отправлял 1–3 запроса, поэтому при включении этого инструмента стоимость одного вызова — это диапазон $0.050–$0.078, а не фиксированное число. Планируйте бюджет по верхней границе.

​
Привязка Image Search: доступна только в Nano Banana 2, и пока бесплатно

searchTypes.imageSearch позволяет модели извлекать визуальные референсы из Google Image Search — полезно для сценариев «сделайте коллаж из реальных фотографий» или «нарисуйте это по реальному объекту».
  • Подтверждается тем, что imageSearchQueries появляется в groundingMetadata, со значениями вроде ["current weather in Tokyo"].
  • Пока дополнительная плата не взимается — стоимость одного вызова даже оказалась немного ниже, чем в контрольной группе без инструмента.
  • Срабатывало в 7 из 12 прогонов: модель сама решает, искать или нет, она не делает запрос каждый раз.
  • Веб-поиск и поиск изображений можно включить одновременно, но модель сама выбирает, что использовать, поэтому стоимость становится непредсказуемой.
searchTypes должен быть объектом, а не массивом.✅ {"searchTypes": {"imageSearch": {}}} — работает❌ {"searchTypes": ["imageSearch"]} — ошибки нет, возвращается 200, и вы всё равно получаете изображение, но поиск изображений не срабатывает ни разу. В теле ответа это никак не видно. Ошибка upstream для формы массива — Proto field is not repeating, cannot start list.

​
responseModalities: ничего не экономит, но убирает нежелательный текст

responseModalities: ["IMAGE"] указывает, что вам нужны только изображения. По 20 прогонов на каждое значение:
  • Все три значения отличаются менее чем на 1%, а ["TEXT","IMAGE"] полностью эквивалентен отсутствию поля (p=0.90).
  • При обычных prompt’ах для генерации 60/60 ответов уже содержали одну часть изображения и вообще не содержали текста, так что переключателю модальностей просто нечего делать. Только в reasoning prompt’ах (инфографика, data charts) примерно в трети случаев добавляется сводный абзац; здесь ["IMAGE"] подавляет его и экономит около 2.8% (p=0.09, статистически незначимо).
Почему экономить нечего: output tokens — это не «изображение + текст», а 1120 для изображения плюс примерно 400 tokens невидимого накладного расхода. Этот накладной расход не отображается ни в одном поле candidatesTokensDetails, но тарифицируется по полному тарифу и составляет 28% стоимости одного вызова, причём не зависит от длины prompt. На его фоне текст почти ничего не значит.Поэтому оценка стоимости одного изображения по 1120 tokens занижает её примерно на 28% — вместо этого сверяйте с candidatesTokenCount или totalTokenCount.

​
Настройка групп

Nano Banana 2 поставляется с двумя группами на APIYI. Переключите в панели управления → Настройки Token: Почему 1.4x? Даже при 1.4x цена всё ещё составляет около 50% от прайс-листа Google — значительно ниже официальной тарификации. Это резервный канал для нагрузок с высокой параллельностью запросов и неожиданных событий risk-control на стороне upstream, обеспечивающий гарантии высокой доступности для корпоративных клиентов. Когда группа по умолчанию перегружена, переключите ваш Token на NanoBananaEnterprise, чтобы переждать всплеск. Рекомендуемая модель тарификации: выберите Pay-as-you-go Priority — подходит и для тарификации Nano Banana 2 на основе token, и для тарификации Nano Banana Pro за вызов, один Token на всю серию.
Интерфейс создания Token: модель тарификации «Приоритетная оплата по мере использования» покрывает тарификацию NB2 на основе token + тарификацию NB Pro за вызов; основная группа Default + резервная группа NanoBananaEnterprise (канал 1.4x)

Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)

Если пойти дальше: если ваш Token также покрывает другие модели генерации изображений (например, GPT-image-2), оставьте более стабильную Default в качестве основной группы и поместите NanoBananaEnterprise в резервный слот — ошибки 429 в основной группе будут автоматически переключаться на корпоративную группу без замены token.

​
Поддерживаемые разрешения и соотношения сторон

​
Разрешения вывода

​
Поддерживаемые соотношения сторон (всего 14)

1:1, 1:4, 4:1, 1:8, 8:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9

​
Размеры вывода для каждого соотношения сторон (пиксели)

Таблица ниже перечисляет фактические размеры вывода Nano Banana 2 для всех 14 соотношений сторон на уровнях разрешения 512px / 1K / 2K / 4K (источник: официальная документация Google). В вашем запросе укажите aspect_ratio для соотношения и image_size (или resolution) для уровня:
По сравнению с 10 соотношениями сторон Nano Banana Pro, Nano Banana 2 добавляет 1:4, 4:1, 1:8, 8:1 — сверхвысокие по высоте/сверхширокие соотношения, идеально подходящие для длинных изображений и инфографики. Это также единственная модель с низким уровнем 512px, отлично подходящим для миниатюр и быстрых предпросмотров.

​
Часто задаваемые вопросы

Nano Banana 2 (gemini-3.1-flash-image-preview) основан на Gemini 3.1 Flash, а Nano Banana Pro (gemini-3-pro-image-preview) — на Gemini 3 Pro. Ключевые различия:
  • ✅ Скорость: Nano Banana 2 быстрее (скорость уровня Flash)
  • ✅ Цена: тарификация по token у Nano Banana 2 дешевле (от $0.025 против $0.09)
  • ✅ Соотношения сторон: Nano Banana 2 поддерживает 14 (на 4 больше)
  • ✅ Привязка к поиску изображений: эксклюзивно для Nano Banana 2
  • ⚠️ Максимальное качество: Nano Banana Pro по-прежнему немного лучше
Рекомендуем! Nano Banana 2 обеспечивает качество почти уровня Pro при более низкой цене и более высокой скорости. Если у вас нет экстремальных требований к качеству, Nano Banana 2 — лучший выбор.Просто измените имя модели с gemini-3-pro-image-preview на gemini-3.1-flash-image-preview.
Для кода / вызовов API мы рекомендуем всегда использовать общее имя модели gemini-3.1-flash-image-preview (без суффикса -4k), а не gemini-3.1-flash-image-preview-4k.
  • Официальное название не содержит -4k: официальное имя модели Google — gemini-3.1-flash-image-preview. Это также основной канал, на поддержание которого мы вкладываем больше всего ресурсов, поэтому он обеспечивает лучшую стабильность и совместимость.
  • Откуда взялось -4k: gemini-3.1-flash-image-preview-4k изначально было конфигурацией, подготовленной для сценариев «chat-to-image» в клиентских приложениях для общения вроде Chatbox — генерации изображений прямо через чат в интерфейсе сообщений.
  • При работе через код + нативный формат Gemini лучше использовать общее имя: если вы вызываете через код, используя нативный формат Gemini (/v1beta/models/.../generateContent), обычное имя модели gemini-3.1-flash-image-preview стабильнее.
Когда вам нужен вывод 4K, нет необходимости полагаться на имя модели -4k — просто укажите разрешение 4K в параметрах запроса (см. выше «Поддерживаемые разрешения и соотношения сторон»).
Image Search Grounding — эксклюзивная функция Nano Banana 2. Она извлекает визуальный контекст из Google Image Search, чтобы генерировать изображения, которые лучше соответствуют реальным объектам. Например, при генерации изображений реальных достопримечательностей она может использовать результаты поиска для повышения точности.
Thinking Mode позволяет модели рассуждать и анализировать перед генерацией изображений, повышая точность для сложных prompt. Установка значения high дает наилучшие результаты, но немного увеличивает время генерации. Лучше всего подходит для задач, требующих точной композиции, отрисовки текста или сложных сцен.
Время генерации зависит от разрешения и режима рассуждения:
  • 1K resolution: ~5-10 секунд
  • 2K resolution: ~10-15 секунд
  • 4K resolution: ~15-25 секунд
  • Включение высокого режима рассуждения добавляет еще несколько секунд
Рекомендуем установить более длительный таймаут (как минимум 360 секунд) на случай редких задержек и пиковых нагрузок.
У API нет лимита параллельных запросов, и он не обрабатывает запросы последовательно. Вы можете безопасно отправлять параллельные запросы сами — запросы не выстраиваются в очередь и не блокируют друг друга. Если 20 пользователей обращаются одновременно, просто отправьте 20 параллельных запросов; никакого дополнительного запроса на квоту или троттлинга не требуется.В отличие от Google AI Studio, канал APIYI не имеет жестких лимитов RPM/RPD, поэтому пакетная генерация для enterprise и пиковый трафик масштабируются линейно.Что на самом деле важно, так это timeout: генерация изображений (особенно 4K или в период пиковых нагрузок) может занимать некоторое время на каждый запрос, поэтому установите таймаут клиента на 360 секунд, чтобы не обрывать запросы, которые нормально обрабатываются.
Если иногда вы получаете 429 (ограничение из-за высокой параллельности), добавьте NanoBananaEnterprise в качестве резервной группы для вашего token (см. выше «Настройка группы»). Когда основная группа перегружена, происходит автоматический переход на резервную, что дополнительно повышает успешность при высокой параллельности запросов.
Поддерживаются форматы image/png и image/jpeg. Загрузка возможна через кодировку base64 или API для файлов.
Все выходные изображения содержат невидимые цифровые водяные знаки SynthID (технология Google для идентификации контента, созданного AI) — они невидимы невооруженным глазом и не влияют на использование.
Полная ошибка выглядит так:
Обычно это вызвано слишком большими загрузками изображений — тело запроса становится слишком большим, и соединение обрывается. Следуйте этим рекомендациям:
  • Ограничьте количество изображений: соблюдайте официальные правила (максимум 14 изображений на prompt) — не добавляйте слишком много референсных изображений.
  • Ограничьте размер каждого изображения: держите каждое изображение меньше 5MB — официальный лимит на одно изображение составляет 7MB, а кодирование base64 увеличивает размер примерно на 1/3, поэтому оставляйте запас.
  • Сжимайте на frontend перед загрузкой: сжимайте изображения на frontend (или на сервере-посреднике) перед отправкой в API — обычная практика заключается в ограничении длинной стороны, конвертации в JPEG/WebP и настройке параметра качества.
  • Перейдите на ввод через URL: нативный формат Gemini поддерживает передачу URL изображения через fileData.fileUri, полностью обходя слишком большие тела запросов base64 — см. Руководство разработчика Nano Banana.

​
Связанная документация

Nano Banana 2 в настоящее время имеет статус Preview. Возможности и цены могут быть изменены. Пожалуйста, следите за обновлениями документации, чтобы получать актуальную информацию.