Примечание автора: руководство по переходу на Nano Banana 2.1 охватывает ID модели, разрешения 1K/2K/4K, 14 эталонных изображений, уровни рассуждений и принципы тарификации. В конце — полный чек-лист для миграции с gemini-3.1-flash-image.
Сразу к главному: Nano Banana 2.1 — обновлённая версия Nano Banana 2 (gemini-3.1-flash-image), которая по-прежнему рассчитана на скорость и стоимость уровня Flash. При переходе со старой модели нужно в основном изменить ID модели и несколько параметров: разрешение, количество эталонных изображений и уровень рассуждений. Перестраивать весь процесс генерации изображений не потребуется.
В этой статье мы не будем расхваливать модель или делать выводы о том, насколько качество изображений лучше, чем у второго поколения: надёжных сравнительных тестов пока нет. Вместо этого разберём по порядку, что нужно изменить при миграции: ID модели, разрешение, эталонные изображения, уровни рассуждений, тарификацию и проверку результата. В конце вы получите готовый к использованию чек-лист для перехода на Nano Banana 2.1. Он пригодится разработчикам и дизайн-командам, которые создают изображения для электронной коммерции и постеры, работают над согласованностью персонажей и объединяют несколько изображений.
Ключевые особенности Nano Banana 2.1 и ID модели
Для начала соберём в одной таблице сведения о Nano Banana 2.1, которые важнее всего при миграции. Все данные взяты из общедоступной карточки модели, документации API и документации APIYI — никаких предположений.
| Параметр | Nano Banana 2.1 | Влияние на миграцию |
|---|---|---|
| ID модели | gemini-nano-banana-2.1 |
Заменяет прежний gemini-3.1-flash-image |
| Дата выпуска | 6 октября 2026 года | Версия выпущена недавно, поэтому детали параметров стоит проверять по актуальной документации |
| Разрешение | 1K / 2K / 4K, по умолчанию 1K | Без явного указания результат будет в 1K — проверьте старые настройки |
| Эталонные изображения | До 14 изображений: не более 4 персонажей и 10 объектов | Нужно пересмотреть ограничения для объединения нескольких изображений и создания серий |
| Уровень рассуждений | minimal / medium (по умолчанию) / high |
Влияет на задержку и стоимость; уровень рекомендуется выбирать под задачу |
| Контекст и вывод | Контекстное окно 131,072, максимальный вывод 32,768 | Больше пространства для длинных промптов и работы с несколькими эталонными изображениями |
ID Nano Banana 2.1 и замена прежней модели
ID модели Nano Banana 2.1 — gemini-nano-banana-2.1. Согласно источникам, она рекомендована для замены gemini-3.1-flash-image, предварительная версия которой была закрыта 25 июня 2026 года. Если в вашем проекте старый ID всё ещё жёстко прописан в коде, сейчас подходящее время для перехода.
Обратите внимание: стиль именования нового ID сильно отличается от прежнего. В gemini-3.1-flash-image указаны версия и серия, а новый ID напрямую использует название бренда Nano Banana. Многие команды сопоставляют имена моделей по префиксу строки в центре конфигурации, переменных окружения и правилах поиска по логам. При миграции всё это нужно обновить, иначе данные могут просто пропасть с панелей мониторинга.
Два описания базовой версии Nano Banana 2.1
Сейчас базовую модель Nano Banana 2.1 описывают двумя способами. В технической документации лучше указать оба:
- В официальной карточке модели сказано, что она основана на Gemini 3.6 Flash.
- В документации API она описана как обновлённая версия Nano Banana 2, сохраняющая скорость и стоимость на уровне Flash.
Эти утверждения не обязательно противоречат друг другу: одно говорит о базовой модели, другое — о преемственности продуктовой линейки. Но во внешних коммуникациях лучше не ограничиваться чем-то одним. Особенно в предложениях для клиентов и при внутреннем согласовании надёжнее уточнить: «В карточке модели указано, что она основана на Gemini 3.6 Flash, а в документации API — что это обновление Nano Banana 2».
Помимо возможностей работы с изображениями, в Nano Banana 2.1 улучшены рендеринг текста и компоновка инфографики, а также поддерживается grounding с использованием Google Web/Image Search. На вход модель принимает текст, изображения, видео и PDF, а на выходе выдаёт изображения и текст. Это расширяет возможности её применения для создания постеров, изображений товаров с надписями, инфографики и других материалов.
Как выбрать разрешение Nano Banana 2.1: 1K/2K/4K
Nano Banana 2.1 поддерживает три разрешения: 1K, 2K и 4K. По умолчанию используется 1K. Среди доступных соотношений сторон — 1:1, 3:2, 2:3, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 и 21:9. Этого хватит для большинства задач: от главных изображений карточек товаров и вертикальных картинок для соцсетей до баннеров, постеров и широкоформатных обложек.
В этой версии исправили проблему, важную при миграции: для широких и панорамных форматов (1:4, 4:1, 1:8, 8:1) в разрешениях 2K/4K устранили артефакты повторяющихся фрагментов. Если раньше вы избегали высокого разрешения для длинных изображений, баннеров или панорам из-за этих артефактов, после миграции стоит пересмотреть настройки.
| Разрешение | Выходные токены (примерно) | Во сколько раз больше токенов, чем у 1K | Подходящие задачи |
|---|---|---|---|
| 1K (по умолчанию) | около 1,120 | 1 раз | Наброски, массовый предварительный просмотр, изображения для соцсетей, A/B-тесты |
| 2K | около 1,680 | около 1.5 раза | Изображения для карточек товаров, обычные постеры, главные изображения лендингов |
| 4K | около 3,780 | около 3.4 раза | Печатные материалы, крупноформатная реклама, исходные изображения для последующей обрезки |
Рекомендации по выбору разрешения Nano Banana 2.1
Количество выходных токенов в таблице — ключевой показатель при официальной тарификации по токенам: чем выше разрешение, тем больше выходных токенов расходуется на одно изображение. Для 4K их требуется примерно в 3.4 раза больше, чем для 1K. Поэтому при оплате по токенам привычка «на всякий случай всегда использовать 4K» заметно увеличит расходы.
Практичный подход — разделить работу на два этапа. Для поиска идей и массового отбора используйте 1K: так можно быстро генерировать изображения и отбраковывать неподходящие варианты. Когда определитесь с направлением, создавайте финальную версию в 2K или 4K. Если же ваша платформа берёт плату за изображение, а 1K–4K стоят одинаково, подход будет другим. Подробнее о тарификации поговорим ниже.
При миграции проверьте ещё одну вещь: указано ли разрешение явно в старом коде. Если прежний вызов полагался на значение по умолчанию, а для вашей задачи нужны изображения с разрешением 2K и выше, после перехода на Nano Banana 2.1 его придётся задать явно. Иначе вы получите изображение в разрешении 1K, которое используется по умолчанию. Названия полей разрешения и соотношения сторон уточняйте в документации используемого интерфейса.
Эталонные изображения в Nano Banana 2.1: как распределить лимит в 14 изображений
Nano Banana 2.1 поддерживает до 14 эталонных изображений. Это важное изменение для объединения изображений и создания визуальных серий. В пределах общего лимита действуют ещё два ограничения: согласованность можно сохранять максимум для 4 персонажей и 10 объектов.
Эти ограничения определяют, как организовать эталонные изображения. Например, для серии брендовых иллюстраций с несколькими персонажами можно закрепить до 4 персонажей, а оставшиеся изображения использовать как образцы сцен, реквизита или стиля. При создании серии изображений товаров лимита в 10 объектов хватит для линейки SKU среднего размера.
Типичные сценарии использования эталонных изображений в Nano Banana 2.1
В исходных материалах выделены четыре основных сценария:
- Создание персонажей: используйте эталонные изображения 1–4 персонажей с разных ракурсов, чтобы сохранить их внешность в разных сценах.
- Товарные серии: используйте товары одной линейки как эталонные объекты для создания главных изображений, изображений в интерьере и групповых композиций в едином стиле.
- Объединение изображений: совместите эталонные изображения сцены, главного объекта, материалов и освещения в одном результате. Подходит для постеров и концепт-артов.
- Брендовая визуальная айдентика: используйте в качестве эталонов цвета бренда, материалы с логотипом и существующие визуальные материалы, чтобы сохранить единый стиль при массовом производстве.
При миграции рекомендуем добавить проверку количества эталонных изображений на уровне вызова: если их больше 14, отклоняйте запрос на стороне клиента и показывайте предупреждение, не дожидаясь ошибки API. При этом ограничения на количество персонажей и объектов относятся к смыслу изображений, поэтому API не обязательно сможет проверить их напрямую. Лучше подсказать дизайнеру в интерфейсе: «За один раз можно закрепить не более 4 персонажей и 10 объектов». Это поможет избежать путаницы между персонажами в результатах генерации.
Чем больше эталонных изображений, тем больше данных обычно приходится обрабатывать на входе, а это влияет на задержку. Если скорость важна, не обязательно каждый раз использовать все 14 изображений: зачастую эффективнее выбрать несколько, которые лучше всего передают нужные характеристики.
Уровни рассуждения Nano Banana 2.1: как выбрать minimal, medium или high
Nano Banana 2.1 поддерживает три уровня рассуждения: minimal, medium (по умолчанию) и high. Чем выше уровень, тем больше рассуждений модель выполняет перед генерацией. Обычно это означает более долгое ожидание и больший расход ресурсов.
Принцип выбора прост: для сложных композиций, размещения текста и объединения нескольких изображений уровень можно повысить, а для простого редактирования — снизить, чтобы сократить время ожидания и расходы. В таблице ниже показано, какой уровень подходит для разных задач.
| Уровень рассуждения | Рекомендуемые задачи | Задержка и стоимость | Рекомендации при миграции |
|---|---|---|---|
minimal |
Замена фона, цветокоррекция, локальные правки, простое редактирование | Минимальные | Подходит для пакетной обработки с высокой параллельной нагрузкой |
medium (по умолчанию) |
Обычные изображения товаров, иллюстрации для соцсетей, постеры с одним основным объектом | Средние | Если сомневаетесь, начните с уровня по умолчанию и используйте его как базовый ориентир |
high |
Сложные композиции, плотное размещение текста, инфографика, объединение нескольких изображений | Максимальные | Включайте только для задач, которым это действительно необходимо |
Как выбирать уровень рассуждения в Nano Banana 2.1
Распространённое заблуждение — включать high для всех задач с высокими требованиями к качеству. На практике для простого редактирования изображений высокий уровень рассуждения даёт ограниченный выигрыш, зато заметно увеличивает время ответа. Это особенно важно в интерактивных сценариях, когда пользователь ждёт результат в реальном времени.
Лучше выбирать уровень на стороне приложения в зависимости от типа задачи. Например, направлять «постер с большим объёмом текста», «объединение 14 эталонных изображений» и «инфографику» на high, «пакетную замену фона» — на minimal, а для остальных задач оставлять medium по умолчанию. Так можно сохранить качество важных результатов и при этом контролировать общую задержку.
Если в старой модели не было настройки уровня рассуждения, после миграции по умолчанию используется medium. На начальном этапе лучше оставить это значение, собрать базовые показатели и затем постепенно снижать или повышать уровень в зависимости от типа задачи. Так вы не измените слишком много переменных одновременно и сможете понять, что именно повлияло на результат.
Тарификация Nano Banana 2.1: за изображение и за токены
Тарификация Nano Banana 2.1 — одна из самых частых причин ошибок при оценке стоимости миграции: здесь есть два подхода. Официальная тарификация зависит от количества выходных токенов, которое различается для 1K, 2K и 4K. В документации APIYI указана цена за изображение — $0.045/шт., одинаковая для всех разрешений от 1K до 4K.
| Подход к тарификации | Единица тарификации | Влияние разрешения на стоимость | Как оценивать затраты | Источник |
|---|---|---|---|---|
| Официальная тарификация по токенам | Выходные токены | Для 4K требуется примерно в 3,4 раза больше токенов, чем для 1K | Оценить общее количество токенов с учётом распределения разрешений | Официальная документация |
| Оплата за изображение | Одно изображение | Одинаковая цена для 1K–4K | Рассчитать стоимость по количеству изображений | Документация APIYI apiyi.com: $0.045/шт. |
Два подхода к тарификации Nano Banana 2.1 нельзя сравнивать напрямую
Оплата за изображение и за токены — это разные способы расчёта. Нельзя просто сопоставить цену за картинку с ценой за миллион токенов. Для осмысленного сравнения нужно учесть собственные задачи: какую долю ваших изображений составляют 1K, 2K и 4K и сколько токенов в среднем приходится на каждое. Затем рассчитайте стоимость по каждому из двух подходов.
При оплате за изображение с одинаковой ценой для 1K–4K дополнительные затраты на высокое разрешение больше не растут вместе с количеством токенов. Для электронной коммерции и печати, где часто нужны финальные изображения в 2K или 4K, это меняет привычный подход: «экспериментировать в 1K, а для финальной версии повышать разрешение». Но изображения в 1K обычно генерируются быстрее, поэтому на этапе экспериментов это разрешение по-прежнему полезно для экономии времени.
💰 О тарификации: в документации APIYI apiyi.com для Nano Banana 2.1 указана цена $0.045 за изображение, одинаковая для 1K–4K. Цены могут меняться, поэтому уточняйте актуальную информацию в консоли и документации. Поддержку всех параметров платформой, включая каждое соотношение сторон и уровень thinking, также проверяйте в консоли.
6 шагов для перехода с gemini-3.1-flash-image на Nano Banana 2.1
Выше мы разобрали отдельные параметры, а теперь объединим их в практический план миграции. Согласно исходным материалам, переход состоит из шести шагов:
- Замените ID модели: измените
gemini-3.1-flash-imageнаgemini-nano-banana-2.1, а также обновите настройки в центре конфигурации, переменные окружения, поиск по журналам и правила мониторинга. - Проверьте разрешение и соотношение сторон: выясните, зависели ли прежние вызовы от разрешения по умолчанию. Явно укажите 2K или 4K там, где это необходимо, и заново оцените выбор высокого разрешения для широкоформатных и панорамных изображений.
- Проверьте ограничение на количество эталонных изображений: настройте проверку на стороне клиента — не более 14 изображений. На уровне продукта предупредите пользователей, что допускается не более 4 персонажей и 10 объектов.
- Оцените уровни рассуждения: сначала используйте
mediumпо умолчанию для получения базовых показателей, затем направляйте задачи наminimalилиhighв зависимости от их типа и следите за изменением задержки и стоимости. - Сравните качество результатов и стоимость: запустите старую и новую модели с одним и тем же набором промптов и эталонных изображений. Сравните качество изображений, отображение текста и стоимость одного изображения.
- Сохраните возможность отката: оставьте в конфигурации переключатель на старую модель, чтобы быстро вернуться к ней при ухудшении качества или неожиданном росте расходов.
Подключение к Nano Banana 2.1 через APIYI
Если вы используете OpenAI-совместимый интерфейс, достаточно установить в клиенте base_url равным https://api.apiyi.com/v1, указать API-ключ APIYI и изменить параметр model на gemini-nano-banana-2.1. С одним API-ключом можно вызывать модели Gemini, OpenAI, Claude и другие. Сравнить старую и новую модели при миграции тоже можно в рамках одного подключения.
Перед миграцией проверьте доступность gemini-nano-banana-2.1 и условия тарификации в списке моделей консоли APIYI. Поддержку отдельных параметров — например, конкретного соотношения сторон или уровня рассуждений high — также стоит сверить с консолью и документацией. Не стоит предполагать, что все официальные параметры уже доступны.
🚀 Совет по миграции: проверьте условия тарификации Nano Banana 2.1 в списке моделей APIYI на apiyi.com. Затем используйте бесплатный тестовый лимит для новых пользователей, чтобы провести тест на небольшой выборке и сравнить результаты старой и новой моделей. После этого решайте, стоит ли переходить на новую модель полностью.
Проверка миграции на Nano Banana 2.1 по журналам использования
При проверке миграции важны не только изображения, но и расходы. В журналах использования APIYI можно посмотреть модель, число вызовов и стоимость по каждому запросу. В первую неделю после миграции рекомендуем ежедневно сравнивать динамику количества вызовов и расходов для старой и новой моделей, чтобы убедиться, что тарификация соответствует ожиданиям. Особое внимание уделите запросам, которые всё ещё обращаются к старому ID модели.
Для проверки качества подготовьте фиксированный набор тестов, который охватывает ваши основные задачи: главные изображения товаров, постеры с текстом, серии изображений с согласованными персонажами и объединение нескольких изображений. Подберите для каждой категории несколько наборов промптов и эталонных изображений, выполните тесты до и после миграции и попросите дизайнеров оценить результаты вслепую. Пока у вас нет собственных данных оценки, не стоит безоговорочно доверять заявлениям о «повсеместном улучшении».
Nano Banana 2.1: частые вопросы (FAQ)
Q1: Как связаны Nano Banana 2.1 и gemini-3.1-flash-image?
Nano Banana 2.1 (`gemini-nano-banana-2.1`) — обновлённая версия Nano Banana 2 (`gemini-3.1-flash-image`) и рекомендуемая ей замена. Модель сохраняет скорость и стоимость уровня Flash. Что касается базовой версии, в официальной карточке модели указано, что она основана на Gemini 3.6 Flash, а в документации API она описана как обновление Nano Banana 2. Рекомендуется указывать обе формулировки.
Q2: Нужно ли менять логику кода при переходе на Nano Banana 2.1?
В большинстве случаев перерабатывать логику не нужно: достаточно изменить ID модели и параметры — разрешение, количество эталонных изображений и уровень рассуждений. Если раньше использовалось разрешение по умолчанию, а для вашей задачи нужны 2K или 4K, его придётся указать явно. При вызове через OpenAI-совместимый интерфейс APIYI apiyi.com для переключения модели достаточно изменить параметр `model`.
Q3: Если цена за 1K–4K одинаковая, всегда ли выгоднее использовать 4K?
При оплате за вызов и одинаковой цене для 1K–4K разрешение 4K не увеличит стоимость одного изображения, но генерация и передача могут занять больше времени, а хранение обойдётся дороже. На этапе экспериментов и массового отбора по-прежнему рекомендуется использовать 1K, а для финального результата — 2K или 4K. Актуальную цену за вызов смотрите в консоли APIYI apiyi.com.
Q4: Какие ограничения известны у Nano Banana 2.1?
Можно использовать до 14 эталонных изображений: согласованность поддерживается максимум для 4 персонажей и 10 объектов. Если нужно больше, задачу придётся разбить на части. Уровень рассуждений `high` увеличивает задержку и стоимость. Сейчас нет публичных и надёжных сравнений качества изображений на практике, поэтому результаты перехода стоит проверить на собственном наборе данных для оценки.
Итоги миграции на Nano Banana 2.1 и контрольный список
Nano Banana 2.1: главное
- Позиционирование: обновление Nano Banana 2, которое заменяет
gemini-3.1-flash-imageи сохраняет скорость и стоимость на уровне Flash. - Базовая модель: в карточке модели указано, что она основана на Gemini 3.6 Flash, а в документации API — что это обновление Nano Banana 2. Стоит указывать оба описания.
- Разрешение: 1K/2K/4K, по умолчанию — 1K. Исправлены артефакты тайлинга в широкоформатных и панорамных изображениях при 2K/4K.
- Эталонные изображения: до 14 изображений, не более 4 персонажей и 10 объектов. Подходит для серий изображений и объединения нескольких изображений.
- Уровень рассуждений: по умолчанию —
medium. Для сложных композиций и размещения текста используйтеhigh, для простого редактирования —minimal. - Тарификация: официально оплата рассчитывается по токенам, а в документации APIYI указана одинаковая цена за изображение. Напрямую сравнивать их нельзя; актуальные цены смотрите в консоли.
Контрольный список миграции на Nano Banana 2.1
| Что проверить | Действие | Критерий готовности |
|---|---|---|
| ID модели | Заменить все вхождения gemini-3.1-flash-image на gemini-nano-banana-2.1 |
В логах использования больше нет вызовов со старым ID |
| Разрешение | Проверить, подходит ли 1K по умолчанию; при необходимости явно указать 2K/4K | Размер выходного изображения соответствует требованиям задачи |
| Соотношение сторон | Повторно проверить 2K/4K для широкоформатных и панорамных изображений | В длинных изображениях и баннерах нет артефактов тайлинга |
| Эталонные изображения | Добавить проверку на клиенте: не более 14 изображений, не более 4 персонажей и 10 объектов | Запросы с превышением лимитов блокируются на клиенте |
| Уровень рассуждений | Установить базовые показатели с medium, затем выбирать уровень в зависимости от задачи |
Задержка и стоимость остаются в допустимых пределах |
| Формат ответа | Проверить совместимость логики обработки изображений и текста в ответе | Дальнейшее сохранение и отображение работают штатно |
| Проверка тарификации | Оценить стоимость с учётом используемых разрешений и сверить цены в консоли | Фактические расходы соответствуют оценке |
| Оценка качества | Использовать фиксированный набор тестов для слепого сравнения старой и новой моделей | Качество в основных сценариях не снизилось |
| Переключатель отката | Сохранить возможность вернуться к старой модели на уровне конфигурации | Откат можно выполнить за несколько минут |
По сути, миграция на Nano Banana 2.1 — это инженерная задача: заменить ID, настроить параметры и проверить результат. Настройте разрешение, эталонные изображения и уровень рассуждений под разные сценарии, а затем проверьте переход с помощью тестового набора и логов использования.
Рекомендуем через APIYI apiyi.com параллельно вызывать старую и новую модели с одним API-ключом, сравнить результаты и проверить тарификацию по логам использования. Убедившись, что всё работает корректно, можно полностью перейти на новую модель.
Автор: техническая команда APIYI
Технические вопросы: свяжитесь с нами через главную страницу сайта APIYI. Дополнительные материалы по интеграции доступны в центре документации docs.apiyi.com
