> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nano Banana 2 Генерация/редактирование изображений

> Последняя модель Google для генерации изображений Nano Banana 2 (gemini-3.1-flash-image-preview) — качество уровня Pro со скоростью уровня Flash, вывод 4K, 14 соотношений сторон, привязка к поиску изображений, $0.055/изображение за вызов, на основе token — от $0.025/изображение.

## Обзор

**Nano Banana 2** (кодовое имя) — это новейшая модель генерации изображений Google, выпущенная 26 февраля 2026 года, с ID модели `gemini-3.1-flash-image-preview`. Она переопределяет соотношение цены и эффективности генерации изображений, предлагая **качество уровня Pro при скорости и стоимости уровня Flash**, и является новейшим флагманом серии Nano Banana.

<Note>
  **🔥 Выпущено 26 февраля 2026 года**: Nano Banana 2 уже доступна! Качество уровня Pro, скорость уровня Flash, тарификация на основе token — всего до 36% от цен Google! 512px всего от \$0.025/изображение! Поддерживает вывод 4K, 14 соотношений сторон, Image Search Grounding и другие эксклюзивные возможности.
</Note>

<Note>
  **🆕 Обновление 29 мая 2026 года (вышел `-preview`)**: Google обновила официальную документацию и выпустила стабильное имя модели **`gemini-3.1-flash-image`** (без `-preview`). APIYI уже поддерживает его.

  * **Старое имя по-прежнему работает**: `gemini-3.1-flash-image-preview` продолжает работать как обычно, **тарификация без изменений**, никаких изменений в коде не требуется.
  * **Оба имени работают**: используйте либо новое имя `gemini-3.1-flash-image`, либо исходное имя `-preview`.

  Важно: Google не уточнила, отличается ли стабильная версия от preview по качеству вывода, фильтрации безопасности или другому поведению. Будем рады, если вы протестируете ее и поделитесь отзывами.
</Note>

<Info>
  Все API изображений работают **синхронно** — нет ID задачи, который нужно опрашивать, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Для этой модели задайте достаточный timeout; см. [Основы и лучшие практики Image API](/ru/api-capabilities/image-api-best-practices).
</Info>

<CardGroup cols={2}>
  <Card title="API преобразования текста в изображение" icon="wand-sparkles" href="/ru/api-capabilities/nano-banana-2-image/text-to-image">
    Генерируйте изображения на основе текстовых prompt. Включает интерактивную песочницу для онлайн-тестирования.
  </Card>

  <Card title="API редактирования изображений" icon="image" href="/ru/api-capabilities/nano-banana-2-image/image-edit">
    Загрузите изображение + инструкции по редактированию, чтобы создать новые изображения. Включает интерактивную песочницу.
  </Card>
</CardGroup>

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

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

Только что выпущенный флагман Google по-прежнему ограничен по мощностям на стороне источника — APIYI глубоко оптимизирует опыт по **надежности**, **стоимости** и **интеграции**:

<CardGroup cols={2}>
  <Card title="Официальный канал · Как Gemini" icon="shield-check">
    На 100% совместимо с нативным Gemini API от Google (`/v1beta/models/.../generateContent`) и паттерном OpenAI SDK — те же тело запроса, поля ответа и коды ошибок. Миграция без кода.
  </Card>

  <Card title="Без ограничений на параллельные запросы" icon="infinity">
    Не ограничено потолками RPM/RPD Google AI Studio. Пакетная генерация корпоративного масштаба и пиковый трафик масштабируются линейно без прерываний из-за квоты.
  </Card>

  <Card title="28-36% от прайсовой цены Google" icon="percent">
    \$0.055 за изображение за вызов (против Google \$0.151), 512px — от \$0.025 за изображение по token-модели (против \$0.045). В сочетании с [бонусами за пополнение](/ru/faq/recharge-promotions) — всего от 30.3% от прайса.
  </Card>

  <Card title="Глобальный доступ без барьеров" icon="globe">
    **Не требуется зарубежный сервер или прокси** — подключайтесь напрямую к `api.apiyi.com` из материковых дата-центров, домашних сетей или зарубежных узлов. Стабильная задержка, без необходимости перестраивать архитектуру для трансграничного доступа.
  </Card>

  <Card title="Полная линейка моделей" icon="layers">
    Та же серия охватывает [Nano Banana Pro](/ru/api-capabilities/nano-banana-image/overview) (максимальное качество), Nano Banana 2 (лучшее соотношение цены и качества) и предыдущий Nano Banana — комбинируйте под разные сценарии.
  </Card>

  <Card title="Профессиональная корпоративная поддержка" icon="handshake">
    Наша команда специализируется на внедрениях генерации изображений в продакшене, с глубоким опытом в выборе моделей, настройке и интеграции — поддержка полного цикла от PoC до продакшена.
  </Card>
</CardGroup>

## Основные возможности

<CardGroup cols={2}>
  <Card title="Качество уровня Pro" icon="sparkles">
    Яркое освещение, богатые текстуры, четкие детали — качество, сопоставимое с Nano Banana Pro, но на гораздо более высокой скорости
  </Card>

  <Card title="Вывод в 4K Ultra-HD" icon="expand">
    Поддерживает разрешения 512px, 1K, 2K, 4K, до 4096×4096
  </Card>

  <Card title="14 соотношений сторон" icon="maximize">
    Новые варианты: 1:4, 4:1, 1:8, 8:1 — всего 14 соотношений сторон, охватывающих больше сценариев использования
  </Card>

  <Card title="Привязка к поиску изображений" icon="search">
    Эксклюзив Nano Banana 2 — извлекает визуальный контекст из Google Image Search
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Точное отображение текста" icon="type">
    Четкий, разборчивый текст на изображениях с поддержкой нескольких языков — идеально для плакатов и маркетинговых материалов
  </Card>

  <Card title="Многоходовое редактирование" icon="message-circle">
    Интерактивное редактирование изображений с итеративной доработкой в чате
  </Card>

  <Card title="Режим рассуждения" icon="brain">
    Настраиваемые минимальный или высокий уровни рассуждения для более точной обработки сложных prompt
  </Card>

  <Card title="Согласованность объекта" icon="users">
    Сохраняет сходство у 5 персонажей и 14 опорных объектов
  </Card>
</CardGroup>

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

| Функция                       | **Nano Banana 2**                  | Nano Banana Pro              | Nano Banana              |
| ----------------------------- | ---------------------------------- | ---------------------------- | ------------------------ |
| ID модели                     | `gemini-3.1-flash-image-preview`   | `gemini-3-pro-image-preview` | `gemini-2.5-flash-image` |
| Качество                      | ⭐⭐⭐⭐⭐ Уровень Pro                  | ⭐⭐⭐⭐⭐ Наивысшее качество     | ⭐⭐⭐⭐ Отличное            |
| Скорость                      | 🚀 Самая высокая                   | 🐢 Медленнее                 | ⚡ Быстро                 |
| Максимальное разрешение       | 4K                                 | 4K                           | 1K                       |
| Соотношения сторон            | 14                                 | 10                           | 10                       |
| Привязка к поиску изображений | ✅ Эксклюзивно                      | ❌                            | ❌                        |
| Тарификация APIYI             | **\$0.055/изображение (за вызов)** | \$0.09/изображение           | \$0.02/изображение       |
| Статус                        | Предварительная версия             | Предварительная версия       | Общедоступно             |

<Tip>
  **Руководство по выбору**:

  * 🔥 **Лучшее соотношение цены и качества** → Nano Banana 2 (на основе token от \$0.025/изображение, качество уровня Pro + скорость уровня Flash)
  * 🎨 **Максимальное качество** → Nano Banana Pro (\$0.09/изображение, наивысшая точность)
  * ⚡ **Минимальная стоимость** → Nano Banana (\$0.025/изображение, быстро и стабильно)
</Tip>

## Цены

<Info>
  **Выбор режима тарификации**: Nano Banana 2 поддерживает два режима тарификации, которые выбираются с помощью настройки «модель тарификации» при создании вашего API token:

  * Выберите **«Оплата по мере использования»** или **«Приоритетная оплата по мере использования»** → тарификация на основе token
  * Выберите **«Оплата за запрос»** или **«Приоритетная оплата за запрос»** → тарификация за вызов (так же, как у Nano Banana Pro)
  * ⚠️ **Не выбирайте гибридную тарификацию**
</Info>

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

| Модель                                             | Цены APIYI        | Официальная цена Google 4K | Скидка              |
| -------------------------------------------------- | ----------------- | -------------------------- | ------------------- |
| **Nano Banana 2** `gemini-3.1-flash-image-preview` | **\$0.055/image** | \$0.151/image              | **🔥 скидка \~64%** |
| Nano Banana Pro `gemini-3-pro-image-preview`       | \$0.09/image      | \$0.24/image               | **\~63% скидки**    |
| Nano Banana `gemini-2.5-flash-image`               | \$0.02/image      | \$0.039/image (только 1K)  | \~50% скидки        |

<Tip>
  **Канал HA для Enterprise**: NanoBananaEnterprise доступен по цене в 1.4 раза выше стандартной ставки Nano Banana Pro (\$0.126/image), предоставляя выделенный резервный вариант высокой доступности для корпоративных нагрузок.
</Tip>

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

| Позиция тарификации                   | Официальная цена Google          | APIYI           | Скидка  |
| ------------------------------------- | -------------------------------- | --------------- | ------- |
| Вход                                  | \$0.50/M tokens                  | \$0.18/M tokens | **36%** |
| Выход (изображения и text объединены) | Изображения \$60/M, Text \$1.5/M | \$21.6/M tokens | **36%** |

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

| Разрешение | Официальная цена Google | APIYI         | Fal AI |
| ---------- | ----------------------- | ------------- | ------ |
| 512px      | \$0.045                 | **\~\$0.025** | \$0.06 |
| 1K         | \$0.067                 | **\~\$0.035** | \$0.08 |
| 2K         | \$0.101                 | **\~\$0.045** | \$0.12 |
| 4K         | \$0.151                 | **\~\$0.07**  | \$0.16 |

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

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

Nano Banana 2 поставляется с двумя группами на APIYI. Переключение в панели управления → **Настройки Token**:

| Группа                 | Тариф | Когда использовать                                                                                                                                          |
| ---------------------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Default`              | 1.0x  | Базовый канал, соответствует таблице цен; рекомендуемый вариант по умолчанию                                                                                |
| `NanoBananaEnterprise` | 1.4x  | Резервный канал — переключайте вручную, когда у варианта по умолчанию не хватает запаса или резко растут тайм-ауты, с приоритетом по пропускной способности |

**Почему 1.4x?** Даже при 1.4x цена все еще составляет около 50% от прайса Google — намного ниже официальной тарификации. Это резервный канал для нагрузок с высокой параллельностью запросов и неожиданных событий контроля рисков на стороне upstream, обеспечивающий гарантии высокой доступности для корпоративных клиентов. Когда у группы по умолчанию не хватает запаса, переключите свой Token на `NanoBananaEnterprise`, чтобы переждать всплеск.

**Рекомендуемая модель тарификации**: выберите `Pay-as-you-go Priority` — она покрывает тарификацию Nano Banana 2 на основе token И тарификацию Nano Banana Pro за вызов, **один Token на всю серию**.

<Frame caption="Token settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)">
  <img src="https://mintcdn.com/apiyillc/EyWjOyg5fLaMGReJ/images/nano-banana-enterprise-token-setup-20260506.png?fit=max&auto=format&n=EyWjOyg5fLaMGReJ&q=85&s=cf85cd8ddaaa541ebbd970a52a98c68f" alt="Интерфейс создания Token: модель тарификации «Pay-as-you-go Priority» покрывает NB2 token-based + NB Pro per-call; основная группа Default + резервная группа NanoBananaEnterprise (канал 1.4x)" width="1270" height="1052" data-path="images/nano-banana-enterprise-token-setup-20260506.png" />
</Frame>

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

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

### Выходные разрешения

| Разрешение | Описание                | Рекомендуемое применение                      |
| ---------- | ----------------------- | --------------------------------------------- |
| 512px      | Низкое разрешение       | Миниатюры, быстрые предпросмотры              |
| 1K         | По умолчанию            | Социальные сети, отображение в вебе           |
| 2K         | Высокое разрешение      | HD-дисплеи, печатные материалы                |
| 4K         | Сверхвысокое разрешение | Профессиональный дизайн, коммерческие постеры |

### Поддерживаемые соотношения сторон (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`) для уровня:

| Соотношение сторон | 512px    | 1K        | 2K        | 4K         |
| ------------------ | -------- | --------- | --------- | ---------- |
| **1:1**            | 512×512  | 1024×1024 | 2048×2048 | 4096×4096  |
| **1:4**            | 256×1024 | 512×2048  | 1024×4096 | 2048×8192  |
| **1:8**            | 192×1536 | 384×3072  | 768×6144  | 1536×12288 |
| **2:3**            | 424×632  | 848×1264  | 1696×2528 | 3392×5056  |
| **3:2**            | 632×424  | 1264×848  | 2528×1696 | 5056×3392  |
| **3:4**            | 448×600  | 896×1200  | 1792×2400 | 3584×4800  |
| **4:1**            | 1024×256 | 2048×512  | 4096×1024 | 8192×2048  |
| **4:3**            | 600×448  | 1200×896  | 2400×1792 | 4800×3584  |
| **4:5**            | 464×576  | 928×1152  | 1856×2304 | 3712×4608  |
| **5:4**            | 576×464  | 1152×928  | 2304×1856 | 4608×3712  |
| **8:1**            | 1536×192 | 3072×384  | 6144×768  | 12288×1536 |
| **9:16**           | 384×688  | 768×1376  | 1536×2752 | 3072×5504  |
| **16:9**           | 688×384  | 1376×768  | 2752×1536 | 5504×3072  |
| **21:9**           | 792×168  | 1584×672  | 3168×1344 | 6336×2688  |

<Info>
  По сравнению с 10 соотношениями сторон Nano Banana Pro, Nano Banana 2 добавляет `1:4`, `4:1`, `1:8`, `8:1` - сверхвысокие по высоте/ширине соотношения, идеально подходящие для длинных изображений и инфографики. Это также единственная модель с низким уровнем разрешения 512px, отлично подходящая для миниатюр и быстрых предпросмотров.
</Info>

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

<AccordionGroup>
  <Accordion title="В чем разница между Nano Banana 2 и Nano Banana Pro?">
    **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 по-прежнему немного лучше
  </Accordion>

  <Accordion title="Стоит ли мне перейти с Nano Banana Pro на Nano Banana 2?">
    **Рекомендуем!** Nano Banana 2 предлагает качество почти уровня Pro по более низкой цене и с более высокой скоростью. Если у вас нет экстремальных требований к качеству, Nano Banana 2 — лучший выбор.

    Просто измените имя модели с `gemini-3-pro-image-preview` на `gemini-3.1-flash-image-preview`.
  </Accordion>

  <Accordion title="Стоит ли использовать gemini-3.1-flash-image-preview или версию с суффиксом -4k?">
    **Для кода / 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 лучше работает с общим именем**: если вы вызываете через code, используя нативный формат Gemini (`/v1beta/models/.../generateContent`), обычное имя модели `gemini-3.1-flash-image-preview` более стабильно.

    Когда вам нужен вывод 4K, нет необходимости полагаться на имя модели `-4k` — просто укажите разрешение 4K в параметрах запроса (см. «Поддерживаемые разрешения и соотношения сторон» выше).
  </Accordion>

  <Accordion title="Что такое Image Search Grounding?">
    Image Search Grounding — эксклюзивная функция Nano Banana 2. Она извлекает визуальный контекст из Google Image Search, чтобы генерировать изображения, которые лучше соответствуют реальным объектам. Например, при генерации изображений реальных достопримечательностей она может опираться на результаты поиска для повышения точности.
  </Accordion>

  <Accordion title="Что делает Thinking Mode?">
    Thinking Mode позволяет модели выполнять рассуждение и анализ перед генерацией изображений, повышая точность для сложных prompt. Установка значения `high` дает лучшие результаты, но немного увеличивает время генерации. Лучше всего подходит для задач, требующих точной композиции, рендеринга текста или сложных сцен.
  </Accordion>

  <Accordion title="Сколько времени занимает генерация изображения?">
    Время генерации зависит от разрешения и режима Thinking Mode:

    * **Разрешение 1K**: \~5-10 секунд
    * **Разрешение 2K**: \~10-15 секунд
    * **Разрешение 4K**: \~15-25 секунд
    * Включение высокого режима Thinking Mode добавляет еще несколько секунд

    Рекомендуем установить более длинный timeout (не менее 360 секунд) на случай редких задержек и пиковых нагрузок.
  </Accordion>

  <Accordion title="Есть ли лимит на параллельные запросы? API работает последовательно? Что делать, если одновременно вызывают 20 пользователей?">
    **У API нет лимита на параллельные запросы, и он не обрабатывает запросы последовательно.** Вы можете безопасно самостоятельно отправлять параллельные запросы — запросы не ставятся в очередь и не блокируют друг друга. Для 20 пользователей, обращающихся одновременно, просто отправьте 20 параллельных запросов; дополнительный запрос на квоту или throttling не требуется.

    В отличие от Google AI Studio, канал APIYI не имеет жестких лимитов RPM/RPD, поэтому корпоративная пакетная генерация и пиковый трафик масштабируются линейно.

    **Что действительно важно — это `timeout`**: генерация изображений (особенно 4K или во время пиковой нагрузки) может занимать некоторое время для каждого запроса, поэтому **установите timeout клиента на 360 секунд**, чтобы не обрывать запросы, которые еще нормально обрабатываются.

    <Tip>
      Если вы иногда получаете 429 (ограничение из-за высокой параллельности), добавьте `NanoBananaEnterprise` как резервную группу для вашего token (см. «Group Setup» выше). Когда основная группа перегружена, происходит автоматический переход на резервную, что еще больше повышает успешность при высокой параллельности.
    </Tip>
  </Accordion>

  <Accordion title="Какие форматы входных изображений поддерживаются?">
    Поддерживает форматы `image/png` и `image/jpeg`. Можно загружать через base64-кодирование или Files API.
  </Accordion>

  <Accordion title="Есть ли у выходных изображений водяные знаки?">
    Все выходные изображения содержат невидимые цифровые водяные знаки SynthID (технология Google для идентификации контента, сгенерированного AI) — они невидимы невооруженным глазом и не влияют на использование.
  </Accordion>

  <Accordion title="Почему я получаю connection reset by peer / write_response_body_failed (500)?">
    Полный текст ошибки выглядит так:

    ```text theme={null}
    [&{{write tcp ip:port->ip:port: write: connection reset by peer Unknown error shell_api_error  write_response_body_failed} 500 }]
    ```

    Это **обычно вызвано слишком большими загрузками изображений — тело запроса становится слишком большим, и соединение обрывается**. Следуйте этим рекомендациям:

    * **Ограничьте количество изображений**: соблюдайте официальные правила (не более 14 изображений на prompt) — не добавляйте слишком много reference images.
    * **Ограничьте размер каждого изображения**: держите размер каждого изображения ниже 5MB — официальный лимит на одно изображение составляет 7MB, а base64-кодирование увеличивает размер примерно на 1/3, поэтому оставляйте запас.
    * **Сжимайте на frontend перед загрузкой**: сжимайте изображения на frontend (или через серверный relay) перед отправкой в API — распространенная практика заключается в ограничении длинной стороны, преобразовании в JPEG/WebP и настройке параметра качества.
    * **Переключитесь на ввод через URL**: нативный формат Gemini поддерживает передачу URL изображения через `fileData.fileUri`, полностью обходя слишком большие base64-тела запроса — см. [Nano Banana Dev Guide](/ru/api-capabilities/nano-banana-dev-guide).
  </Accordion>
</AccordionGroup>

## Сопутствующая документация

* [Nano Banana Pro Image Generation](/en/api-capabilities/nano-banana-image) - Предыдущая флагманская версия
* [Nano Banana Image Editing](/en/api-capabilities/nano-banana-image-edit) - Функции редактирования изображений
* [Image Generation Comparison Testing](https://imagen.apiyi.com/)
* [API Usage Manual](/ru/api-manual)

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