Skip to main content
🔥 Последний релиз: Google выпустила Nano Banana 2 (gemini-3.1-flash-image-preview) 26 февраля 2026 года — качество уровня Pro со скоростью уровня Flash, оплата по мере использования от всего $0.025/изображение! Посмотреть документацию Nano Banana 2
🆕 Обновление от 29 мая 2026 года (-preview снят): Google обновила официальную документацию и выпустила стабильное название модели gemini-3-pro-image (без -preview). APIYI уже поддерживает его.
  • Старое название по-прежнему работает: gemini-3-pro-image-preview продолжает работать как обычно, цены без изменений, код менять не нужно.
  • Оба названия работают: используйте либо новое имя gemini-3-pro-image, либо исходное имя -preview.
Имейте в виду: Google не уточнила, отличается ли стабильная версия от preview по качеству вывода, фильтрации безопасности или другим параметрам. Будем рады, если вы протестируете и поделитесь отзывом.
Все image APIs являются синхронными — здесь нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Установите для этой модели щедрый таймаут; см. Основы Image API и лучшие практики.
Nano Banana Pro (кодовое имя) — это серия моделей генерации изображений Google, которая в настоящее время доступна в следующих версиях:

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

  • Nano Banana 2: gemini-3.1-flash-image-preview (🔥 Запущен 26 февраля 2026 года) — Посмотреть подробности
  • 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 года)
Основные преимущества
  • 🔥 Новые возможности Nano Banana Pro:
    • 🎯 Поддержка высокого разрешения 4K: Поддерживает три разрешения: 1K, 2K, 4K, до 4096×4096
    • 📝 Лучший рендеринг текста: Четкий и читаемый текст на изображениях, идеально для плакатов и рекламы
    • Локальное редактирование: Поддерживает настройку угла камеры, фокуса, цветокоррекции и освещения сцены
    • 🧠 Умное рассуждение: Основано на Gemini 3 Pro, лучше понимает сложные prompt
  • 🚀 Универсальные преимущества:
    • Скорость генерации: Nano Banana Pro ~20 секунд, предыдущая версия ~10 секунд
    • 💰 Доступные цены: В сочетании с бонусами за пополнение, очень выгодно
    • 🔄 Полная совместимость: Полностью совместим с официальным форматом Google Gemini API
    • 🎨 Технологии Google: Основано на новейших и самых мощных технологиях Google для генерации изображений и редактирования

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

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

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

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

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

Почему Nano Banana Pro от APIYI?

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

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

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

Нет лимитов параллельных запросов

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

31-38% от цены по прайс-листу Google

$0.09 за изображение за один вызов (против Google 4K $0.24). В сочетании с бонусами за пополнение — всего от 31.25% от прайса, экономия на 4K до 68.75%.

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

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

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

В одной серии доступны Nano Banana 2 (лучшее соотношение цены и скорости Flash), Nano Banana Pro (максимальное качество) и классический Nano Banana — комбинируйте под разные сценарии.

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

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

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

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

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

Следующие официальные возможности Google не поддерживаются через APIYI и требуют отдельной тарификации:
  • Grounding с Google Search: Информация поиска в реальном времени через tools: [{"google_search": {}}]
  • thinkingConfig (режим рассуждения): Поддерживается только на Nano Banana 2, но не на Nano Banana Pro
  • Image Search Grounding: Эксклюзивная функция Nano Banana 2
Все остальные возможности генерации изображений и редактирования полностью поддерживаются.

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

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

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

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

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

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

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

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

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

  • gpt-4o-imagegemini-2.5-flash-image
  • sora_imagegemini-2.5-flash-image
  • Старая версия Nano Banana → gemini-2.5-flash-image
Оставьте остальные параметры без изменений, чтобы переключение было бесшовным.

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

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

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

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

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

FAQ

Для лучшего соотношения цены и качества выбирайте 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.
Рекомендуется для новых проектов: 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)
  • Миграции существующих проектов
Просто измените имя модели с gpt-4o-image или sora_image на gemini-3-pro-image-preview (рекомендуемая Pro) или gemini-2.5-flash-image (устаревшая), оставив остальные параметры без изменений.
Модель возвращает данные изображения в формате base64, обычно в PNG или JPEG. Код автоматически определяет формат и сохраняет его в соответствующий тип файла.
Да, Nano Banana Pro поддерживает как генерацию изображений, так и редактирование. См. Справочник API по редактированию изображений.
Полная ошибка выглядит так:
Обычно это вызвано слишком большими загрузками изображений — тело запроса становится слишком большим, и соединение обрывается. Следуйте этим рекомендациям:
  • Ограничьте количество изображений: соблюдайте официальные правила (максимум 14 изображений на prompt) — не добавляйте слишком много референсных изображений.
  • Ограничьте размер одного изображения: держите размер каждого изображения меньше 5MB — официальный лимит на одно изображение составляет 7MB, а кодирование base64 увеличивает размер примерно на 1/3, поэтому оставляйте запас.
  • Сжимайте на frontend перед загрузкой: сжимайте изображения на frontend (или через серверный relay) перед отправкой в API — обычно ограничивают длинную сторону, конвертируют в JPEG/WebP и подбирают параметр качества.
  • Переключитесь на ввод через URL: нативный формат Gemini поддерживает передачу URL изображения через fileData.fileUri, полностью обходя слишком большие тела запросов base64 — см. Руководство разработчика Nano Banana.

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