> ## 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 Pro

> API генерации изображений Nano Banana Pro (Gemini 3 Pro) — поддержка 4K, улучшенный рендеринг текста. Пользовательское разрешение, 10 соотношений сторон, быстрая генерация за 10 секунд, скидка 70-83% по сравнению с официальной тарификацией.

<Note>
  **🔥 Последний релиз**: Google выпустила **Nano Banana 2** (`gemini-3.1-flash-image-preview`) 26 февраля 2026 года — качество уровня Pro со скоростью уровня Flash, оплата по мере использования от всего \$0.025/изображение! [Посмотреть документацию Nano Banana 2](/ru/api-capabilities/nano-banana-2-image/overview)
</Note>

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

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

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

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

**Nano Banana Pro** (кодовое имя) — это серия моделей генерации изображений Google, которая в настоящее время доступна в следующих версиях:

### Последние версии

* **Nano Banana 2**: `gemini-3.1-flash-image-preview` (🔥 Запущен 26 февраля 2026 года) — [Посмотреть подробности](/ru/api-capabilities/nano-banana-2-image/overview)
* **Nano Banana Pro**: `gemini-3-pro-image-preview` (Запущен 20 ноября 2025 года)

### Предыдущие версии

* **Официальный релиз**: `gemini-2.5-flash-image` (стабильная версия, поддерживает 10 соотношений сторон)
* **Preview Version**: `gemini-2.5-flash-image-preview` (⚠️ Прекращена 30 октября 2025 года)

<Card>
  **Основные преимущества**

  * 🔥 **Новые возможности Nano Banana Pro**:
    * 🎯 **Поддержка высокого разрешения 4K**: Поддерживает три разрешения: 1K, 2K, 4K, до 4096×4096
    * 📝 **Лучший рендеринг текста**: Четкий и читаемый текст на изображениях, идеально для плакатов и рекламы
    * ✨ **Локальное редактирование**: Поддерживает настройку угла камеры, фокуса, цветокоррекции и освещения сцены
    * 🧠 **Умное рассуждение**: Основано на Gemini 3 Pro, лучше понимает сложные prompt

  * 🚀 **Универсальные преимущества**:
    * ⚡ **Скорость генерации**: Nano Banana Pro \~20 секунд, предыдущая версия \~10 секунд
    * 💰 **Доступные цены**: В сочетании с бонусами за пополнение, очень выгодно
    * 🔄 **Полная совместимость**: Полностью совместим с официальным форматом Google Gemini API
    * 🎨 **Технологии Google**: Основано на новейших и самых мощных технологиях Google для генерации изображений и редактирования
</Card>

## Интерактивное тестирование API

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

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

## Почему Nano Banana Pro от 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="31-38% от цены по прайс-листу Google" icon="percent">
    \$0.09 за изображение за один вызов (против Google 4K \$0.24). В сочетании с [бонусами за пополнение](/ru/faq/recharge-promotions) — всего от 31.25% от прайса, экономия на 4K до 68.75%.
  </Card>

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

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

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

## Способ вызова

Используйте нативный формат Gemini API Google:

```
POST /v1beta/models/gemini-3-pro-image-preview:generateContent
```

<Tip>
  * ✅ Поддерживает высокое разрешение 4K (1K / 2K / 4K)
  * ✅ 10 соотношений сторон на выбор
  * ✅ Лучший в отрасли рендеринг текста
  * ✅ Продвинутое локальное редактирование
  * 📖 Полностью совместимо с официальным форматом API Google, см. `ai.google.dev/gemini-api/docs/image-generation`
</Tip>

### Неподдерживаемые возможности

<Warning>
  Следующие официальные возможности Google **не поддерживаются** через APIYI и требуют отдельной тарификации:

  * **Grounding с Google Search**: Информация поиска в реальном времени через `tools: [{"google_search": {}}]`
  * **thinkingConfig** (режим рассуждения): Поддерживается только на Nano Banana 2, но не на Nano Banana Pro
  * **Image Search Grounding**: Эксклюзивная функция Nano Banana 2

  Все остальные возможности генерации изображений и редактирования полностью поддерживаются.
</Warning>

## Сравнение цен

| Модель                      | Стоимость                          | Преимущество                                     |
| --------------------------- | ---------------------------------- | ------------------------------------------------ |
| **Nano Banana Pro** (4K)    | \$0.09/image (\~¥0.52 с бонусами)  | 🔥 Поддержка 4K, \~38% от официальной цены       |
| **Nano Banana Pro** (1K-2K) | \$0.09/image (\~¥0.52 с бонусами)  | 🔥 Высокое разрешение, \~67% от официальной цены |
| **Nano Banana**             | \$0.025/image (\~¥0.15 с бонусами) | ⭐ Быстрая генерация, 52% от официальной цены     |
| gpt-image-1                 | Выше                               | -                                                |
| flux-kontext-pro            | \$0.035/image                      | На уровне                                        |

<Tip>
  **Рекомендация по соотношению цены и эффективности**:

  * **Nano Banana Pro**: поддержка 4K, наилучший рендеринг текста, стоимость \~38-67% от официальной
  * **NanoBananaEnterprise**: доступен enterprise-канал HA с коэффициентом 1.4x (\$0.126/image) для задач с высокими требованиями к доступности
  * **Nano Banana**: быстрая генерация (\~10 секунд), 52% от официальной цены, подходит для регулярной генерации изображений высокого качества
</Tip>

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

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

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

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

**Рекомендуемая модель тарификации**: выберите `Pay-as-you-go Priority` — она покрывает тарификацию Nano Banana Pro за вызов И тарификацию Nano Banana 2 по token, **один 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: модель тарификации «Приоритетная оплата по мере использования» покрывает тарификацию NB Pro за вызов + тарификацию NB2 по token; основная группа 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 на основной автоматически переведут на корпоративную группу без смены Token.
</Tip>

## Примечания по совместимости

Если вы ранее использовали следующие модели, просто замените название модели:

### Обновите до последней версии

* Любая старая версия → `gemini-3-pro-image-preview` (🔥 Рекомендуется, Nano Banana Pro)
  * Поддерживает вывод высокого разрешения 4K
  * Лучшая поддержка рендеринга текста
  * Функции локального редактирования

### Используйте стабильную версию

* `gpt-4o-image` → `gemini-2.5-flash-image`
* `sora_image` → `gemini-2.5-flash-image`
* Старая версия Nano Banana → `gemini-2.5-flash-image`

Оставьте остальные параметры без изменений, чтобы переключение было бесшовным.

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

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

Nano Banana Pro поддерживает три уровня разрешения — 1K, 2K, 4K (уровень 512px доступен только в Nano Banana 2):

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

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

В таблице ниже указаны фактические размеры вывода Nano Banana Pro для всех 10 соотношений сторон на уровнях разрешения 1K / 2K / 4K (источник: официальная документация Google). В вашем запросе задайте `aspect_ratio` для соотношения сторон и `image_size` (или `resolution`) для уровня:

| Соотношение сторон | 1K        | 2K        | 4K        |
| ------------------ | --------- | --------- | --------- |
| **1:1**            | 1024×1024 | 2048×2048 | 4096×4096 |
| **2:3**            | 848×1264  | 1696×2528 | 3392×5056 |
| **3:2**            | 1264×848  | 2528×1696 | 5056×3392 |
| **3:4**            | 896×1200  | 1792×2400 | 3584×4800 |
| **4:3**            | 1200×896  | 2400×1792 | 4800×3584 |
| **4:5**            | 928×1152  | 1856×2304 | 3712×4608 |
| **5:4**            | 1152×928  | 2304×1856 | 4608×3712 |
| **9:16**           | 768×1376  | 1536×2752 | 3072×5504 |
| **16:9**           | 1376×768  | 2752×1536 | 5504×3072 |
| **21:9**           | 1584×672  | 3168×1344 | 6336×2688 |

<Info>
  Если вам нужны `1:4`, `4:1`, `1:8`, `8:1` сверхвысокие/сверхширокие соотношения сторон или уровень низкого разрешения 512px, используйте [Nano Banana 2](/ru/api-capabilities/nano-banana-2-image/overview) (14 соотношений сторон + 512px).
</Info>

## FAQ

<AccordionGroup>
  <Accordion title="Стоит ли выбирать Nano Banana 2 или Pro?">
    **Для лучшего соотношения цены и качества** выбирайте **Nano Banana 2** (`gemini-3.1-flash-image-preview`):

    * Качество уровня Pro + скорость уровня Flash
    * Оплата по мере использования, всего от \$0.025/изображение
    * 14 соотношений сторон (на 4 больше, чем у Pro)
    * Эксклюзивно: thinking mode, Image Search Grounding

    **Для максимального качества** выбирайте **Nano Banana Pro** (`gemini-3-pro-image-preview`):

    * Наивысшая точность
    * \$0.09/запрос

    Подробнее см. в [документации Nano Banana 2](/ru/api-capabilities/nano-banana-2-image/overview).
  </Accordion>

  <Accordion title="Стоит ли выбирать версию Pro или устаревшую версию?">
    **Рекомендуется для новых проектов: Nano Banana Pro** (`gemini-3-pro-image-preview`)

    ✅ **Преимущества версии Pro**:

    * Поддержка сверхвысокого разрешения 4K (1K, 2K, 4K)
    * Лучшая в отрасли качество рендеринга текста
    * Расширенные функции локального редактирования
    * Всего \~38-67% от официальной тарификации

    ⚡ **Устаревшая версия** (`gemini-2.5-flash-image`) подходит для:

    * Сценариев с чувствительностью к бюджету (\~\$0.025/изображение против \$0.09/изображение)
    * Необходимости быстрой генерации (10s против 20s)
    * Миграции существующих проектов
  </Accordion>

  <Accordion title="Как переключиться с других моделей изображений на Nano Banana?">
    Просто измените имя модели с `gpt-4o-image` или `sora_image` на `gemini-3-pro-image-preview` (рекомендуемая Pro) или `gemini-2.5-flash-image` (устаревшая), оставив остальные параметры без изменений.
  </Accordion>

  <Accordion title="В каком формате возвращаются сгенерированные изображения?">
    Модель возвращает данные изображения в формате base64, обычно в PNG или JPEG. Код автоматически определяет формат и сохраняет его в соответствующий тип файла.
  </Accordion>

  <Accordion title="Поддерживаются ли функции редактирования изображений?">
    Да, Nano Banana Pro поддерживает как генерацию изображений, так и редактирование. См. [Справочник API по редактированию изображений](/ru/api-capabilities/nano-banana-image/image-edit).
  </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) — не добавляйте слишком много референсных изображений.
    * **Ограничьте размер одного изображения**: держите размер каждого изображения меньше 5MB — официальный лимит на одно изображение составляет 7MB, а кодирование base64 увеличивает размер примерно на 1/3, поэтому оставляйте запас.
    * **Сжимайте на frontend перед загрузкой**: сжимайте изображения на frontend (или через серверный relay) перед отправкой в API — обычно ограничивают длинную сторону, конвертируют в JPEG/WebP и подбирают параметр качества.
    * **Переключитесь на ввод через URL**: нативный формат Gemini поддерживает передачу URL изображения через `fileData.fileUri`, полностью обходя слишком большие тела запросов base64 — см. [Руководство разработчика Nano Banana](/ru/api-capabilities/nano-banana-dev-guide).
  </Accordion>
</AccordionGroup>

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

* [Nano Banana 2 для генерации изображений](/ru/api-capabilities/nano-banana-2-image/overview)
* [Тарификация Nano Banana](/ru/api-capabilities/nano-banana-pricing)
* [Другие модели генерации изображений](/en/api-capabilities/gpt-image-1)
* [Руководство по использованию API](/ru/api-manual)