Перейти к основному содержанию

​
Обзор

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

API преобразования текста в изображение

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

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

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

​
Доверьте интеграцию AI-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

Он сначала получает текстовую версию этой страницы (добавьте .md к любому URL документации), а затем пишет код под стек вашего проекта — таймаут, защитный парсинг parts, сжатие перед загрузкой и параметры разрешения уже включены в требования.

Выполните интеграцию / устранение неполадок генерации изображений по тексту и редактирования изображений Nano Banana 2 (gemini-3.1-flash-image) в этом проекте.

Прежде чем писать код, изучите документацию: запросите https://docs.apiyi.com/en/api-capabilities/nano-banana-2-image/overview.md для получения текстовой версии этой страницы. Для более подробной информации о параметрах добавьте …

  1. Таймаут: вызывайте нативный формат Gemini по адресу POST https://api.apiyi.com/v1beta/models/gemini-3.1-flash-image:generateContent и увеличьте клиентский таймау …

Всего 7 требований. Нажмите кнопку ниже, чтобы скопировать prompt целиком.

​
Почему 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/изображение, качество уровня Pro + скорость уровня Flash)
  • 🎨 Максимальное качество → Nano Banana Pro ($0.09/изображение, наивысшая точность)
  • ⚡ Минимальная стоимость → Nano Banana ($0.025/изображение, высокая скорость и стабильность)

​
Цены

Выбор режима тарификации: Nano Banana 2 поддерживает два режима тарификации, которые можно выбрать в настройке «Модель тарификации» при создании API token:
  • Выберите Оплата по факту использования или Оплата по факту использования с приоритетом → тарификация по токенам
  • Выберите Оплата за запрос или Оплата за запрос с приоритетом → тарификация за вызов (как у Nano Banana Pro)
  • ⚠️ НЕ выбирайте гибридную тарификацию

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

Корпоративный канал с высокой доступностью: NanoBananaEnterprise доступен по ставке 1,4× от стандартной ставки Nano Banana Pro ($0.126/изображение) и обеспечивает выделенный резервный канал с высокой доступностью для корпоративных нагрузок.

​
Тарификация по токенам (эксклюзивно для Nano Banana 2)

​
Примерная стоимость при тарификации по токенам

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

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

Приведённые ниже цифры получены в ходе живого тестирования на рабочем шлюзе 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, отлично подходящим для миниатюр и быстрых предпросмотров.

​
FAQ

Nano Banana 2 (gemini-3.1-flash-image) основана на Gemini 3.1 Flash, а Nano Banana Pro (gemini-3-pro-image) — на Gemini 3 Pro. Ключевые различия:
  • ✅ Скорость: Nano Banana 2 работает быстрее (скорость уровня Flash)
  • ✅ Цена: тарификация 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 на gemini-3.1-flash-image.
Для кода и вызовов API мы рекомендуем всегда использовать общее название модели gemini-3.1-flash-image (без суффикса -4k), а не gemini-3.1-flash-image-4k.
  • В официальном названии нет -4k: официальное название модели Google — gemini-3.1-flash-image. Это также основной канал, в поддержку которого мы вкладываем больше всего ресурсов, поэтому он обеспечивает наилучшую стабильность и совместимость.
  • Откуда взялось -4k: изначально gemini-3.1-flash-image-4k была конфигурацией для сценариев «чат-в-изображение» в диалоговых клиентах, таких как Chatbox: генерации изображений прямо в чате интерфейса обмена сообщениями.
  • Для кода и нативного формата Gemini предпочтительно общее название: при вызове из кода с использованием нативного формата Gemini (/v1beta/models/.../generateContent) стандартное название модели gemini-3.1-flash-image работает стабильнее.
Для получения изображения в разрешении 4K не нужно использовать название модели -4k — просто укажите разрешение 4K в параметрах запроса (см. раздел «Поддерживаемые разрешения и соотношения сторон» выше).
Привязка к результатам поиска изображений — эксклюзивная функция Nano Banana 2. Она использует визуальный контекст из Google Image Search для генерации изображений, которые лучше соответствуют объектам реального мира. Например, при генерации изображений реальных достопримечательностей модель может учитывать результаты поиска, чтобы повысить точность.
Режим рассуждения позволяет модели обдумать задачу и провести анализ перед генерацией изображений, повышая точность при работе со сложными промптами. Значение high обеспечивает наилучшие результаты, но немного увеличивает время генерации. Этот режим лучше всего подходит для задач, требующих точной композиции, отрисовки текста или создания сложных сцен.
Время генерации зависит от разрешения и режима рассуждения:
  • Разрешение 1K: ~5–10 секунд
  • Разрешение 2K: ~10–15 секунд
  • Разрешение 4K: ~15–25 секунд
  • Включение высокого уровня рассуждения добавляет несколько секунд
Рекомендуем установить более длительный тайм-аут (не менее 360 секунд) на случай задержек и пиковой нагрузки.
У API нет ограничения на параллельные запросы, и запросы не обрабатываются последовательно. Вы можете самостоятельно безопасно отправлять параллельные запросы — они не выстраиваются в очередь и не блокируют друг друга. Если одновременно отправляют запросы 20 пользователей, просто выполните 20 параллельных запросов; дополнительный запрос квоты или ограничение частоты не требуются.В отличие от Google AI Studio, канал APIYI не устанавливает жёстких ограничений RPM/RPD, поэтому масштабирование пакетной генерации для корпоративных задач и при пиковой нагрузке происходит линейно.На самом деле важно учитывать timeout: генерация изображений (особенно в разрешении 4K или при пиковой нагрузке) может занимать некоторое время для каждого запроса, поэтому установите тайм-аут клиента на 360 секунд, чтобы не прерывать запросы, которые обрабатываются в штатном режиме.
Если время от времени вы получаете ошибку 429 (ограничение из-за большого числа параллельных запросов), добавьте NanoBananaEnterprise в качестве резервной группы для своего токена (см. раздел «Настройка группы» выше). Когда основная группа будет перегружена, произойдёт автоматическое переключение на резервную, что дополнительно повысит долю успешных запросов при высокой нагрузке.
Поддерживаются форматы image/png и image/jpeg. Передавайте изображения как base64 непосредственно в запросе или указывайте общедоступный URL изображения через fileData.fileUri. Платформа не поддерживает загрузку файлов через Files API; см. Поддерживает ли APIYI Files API?.
На всех выходных изображениях присутствуют невидимые цифровые водяные знаки SynthID (технология Google для идентификации контента, созданного ИИ). Они незаметны невооружённым глазом и не влияют на использование.
Полный текст ошибки выглядит так:
Обычно это происходит из-за слишком больших загружаемых изображений: тело запроса становится слишком объёмным, и соединение обрывается. Следуйте этим рекомендациям:
  • Ограничьте количество изображений: соблюдайте официальные правила (не более 14 изображений на промпт) и не добавляйте слишком много изображений для справки.
  • Ограничьте размер каждого изображения: размер каждого изображения должен быть меньше 5 МБ. Официальный предел для одного изображения — 7 МБ, а кодирование base64 увеличивает размер примерно на треть, поэтому оставляйте запас.
  • Сжимайте изображения на стороне клиента перед загрузкой: сжимайте изображения на стороне клиента (или через серверный релей), прежде чем отправлять их в API. Обычно для этого ограничивают длину большей стороны, преобразуют изображения в JPEG/WebP и настраивают параметр качества.
  • Перейдите на передачу URL: нативный формат Gemini поддерживает передачу URL изображения через fileData.fileUri, что полностью исключает слишком большие тела запросов base64. См. Руководство разработчика Nano Banana.

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

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