🔥 Последний релиз: Google выпустила Nano Banana 2 (
gemini-3.1-flash-image) 26 февраля 2026 года — качество уровня Pro со скоростью уровня Flash и оплата по факту использования всего от $0.025 за изображение! Открыть документацию Nano Banana 2🆕 Обновление от 29 мая 2026 года (вышла
-preview): Google обновила официальную документацию и выпустила стабильное название модели gemini-3-pro-image (без -preview). APIYI уже поддерживает эту модель.- Теперь в этой документации везде используется стабильное название
gemini-3-pro-image— используйте его для новых интеграций. - Старое название по-прежнему работает:
gemini-3-pro-image-previewпродолжает работать как обычно, цены не изменились, изменения в коде не требуются.
Все API для работы с изображениями синхронные — идентификатора задачи для опроса статуса нет, а если соединение с клиентом прервётся, результат будет потерян, хотя запрос всё равно будет тарифицирован. Установите для этой модели достаточно большой тайм-аут; см. Основные сведения об API изображений и рекомендации.
Последние версии
- Nano Banana 2.1:
gemini-nano-banana-2.1(🆕 Выпущена 6 октября 2026 года; улучшенная версия Nano Banana 2) — Подробнее - Nano Banana 2:
gemini-3.1-flash-image(🔥 Выпущена 26 февраля 2026 года) — Подробнее - Nano Banana Pro:
gemini-3-pro-image(Выпущена 20 ноября 2025 года)
Предыдущие версии
- Официальный релиз:
gemini-2.5-flash-image(стабильная версия, поддерживает 10 соотношений сторон) - Предварительная версия:
gemini-2.5-flash-image-preview(⚠️ Поддержка прекращена 30 октября 2025 года)
Ключевые преимущества
-
🔥 Новые возможности Nano Banana Pro:
- 🎯 Поддержка высокого разрешения 4K: поддерживает разрешения 1K, 2K и 4K, до 4096×4096
- 📝 Мастер отрисовки текста: чёткий и разборчивый текст на изображениях — идеально для плакатов и рекламы
- ✨ Локальное редактирование: поддерживает настройку ракурса камеры, фокуса, цветокоррекции и освещения сцены
- 🧠 Интеллектуальное рассуждение: модель основана на Gemini 3 Pro и лучше понимает сложные промпты
-
🚀 Универсальные преимущества:
- ⚡ Скорость генерации: Nano Banana Pro — около 20 секунд, предыдущая версия — около 10 секунд
- 💰 Доступные цены: с учётом бонусов за пополнение — чрезвычайно выгодно
- 🔄 Полная совместимость: полностью совместима с официальным форматом Google Gemini API
- 🎨 Технологии Google: основана на новейших и самых передовых технологиях Google для генерации и редактирования изображений
Интерактивное тестирование API
API преобразования текста в изображение
Введите текстовый prompt для генерации изображений, с интерактивной песочницей для онлайн-тестирования.
API редактирования изображений
Загрузите изображение + инструкции по редактированию, чтобы генерировать отредактированные изображения, с интерактивной песочницей для онлайн-тестирования.
Доверьте интеграцию ИИ-агенту
Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor
Сначала он загрузит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код под стек вашего проекта — таймаут, защитный парсинг parts, сжатие перед загрузкой и параметры разрешения уже включены в требования.
Интегрируйте / выполните отладку генерации изображений по тексту и редактирования изображений Nano Banana Pro (
gemini-3-pro-image) в этом проекте.Прочтите документацию перед тем, как писать код: загрузите https://docs.apiyi.com/en/api-capabilities/nano-banana-image/overview.md, чтобы получить текстовую версию этой страницы. Для более подробной информации о параметрах аналогично добавьте
.md…
- Таймаут: вызывайте нативный формат Gemini по адресу
POST https://api.apiyi.com/v1beta/models/gemini-3-pro-image:generateContent. Установите клиентский таймаут для каждого разрешения …
Всего 7 требований. Используйте кнопку ниже, чтобы скопировать prompt целиком.
От каких ошибок уберегает этот prompt
От каких ошибок уберегает этот prompt
Почему 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:Неподдерживаемые функции
Сравнение цен
Настройка групп
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 settings: Billing model = Pay-as-you-go Priority, primary group = Default, fallback group = NanoBananaEnterprise (1.4x)
Примечания о совместимости
Если вы ранее использовали следующие модели, просто замените название модели:Обновление до последней версии
- Любая старая версия →
gemini-3-pro-image(🔥 Рекомендуется, Nano Banana Pro)- Поддержка вывода изображений высокого разрешения 4K
- Самые мощные возможности отрисовки текста
- Функции локального редактирования
Использование стабильной версии
gpt-4o-image→gemini-2.5-flash-imagesora_image→gemini-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).Часто задаваемые вопросы
Что выбрать: Nano Banana 2 или Pro?
Что выбрать: Nano Banana 2 или Pro?
Для оптимального соотношения цены и качества выберите Nano Banana 2 (
gemini-3.1-flash-image):- Качество уровня Pro и скорость уровня Flash
- Оплата по факту использования, от $0.025 за изображение
- 14 соотношений сторон (на 4 больше, чем у Pro)
- Эксклюзивные возможности: режим рассуждения, привязка к поиску изображений
gemini-3-pro-image):- Наивысшая точность
- $0.09 за запрос
Что выбрать: версию Pro или устаревшую версию?
Что выбрать: версию Pro или устаревшую версию?
Рекомендуем для новых проектов: Nano Banana Pro (
gemini-3-pro-image)✅ Преимущества версии Pro:- Поддержка сверхвысокого разрешения 4K (1K, 2K, 4K)
- Лучшая в отрасли отрисовка текста
- Расширенные возможности локального редактирования
- Стоимость составляет лишь ~38–67% от официальной цены
gemini-2.5-flash-image) подходит для:- Сценариев с ограниченным бюджетом (~$0.025 за изображение вместо $0.09)
- Случаев, когда нужна быстрая генерация (10 с вместо 20 с)
- Миграции существующего проекта
Как перейти с других моделей генерации изображений на Nano Banana?
Как перейти с других моделей генерации изображений на Nano Banana?
Просто замените название модели
gpt-4o-image или sora_image на gemini-3-pro-image (рекомендуем Pro) или gemini-2.5-flash-image (устаревшая версия), оставив остальные параметры без изменений.В каком формате генерируются изображения?
В каком формате генерируются изображения?
Модель возвращает данные изображения в формате base64, обычно в формате PNG или JPEG. Код автоматически определяет формат и сохраняет изображение в файл соответствующего типа.
Поддерживаются ли функции редактирования изображений?
Поддерживаются ли функции редактирования изображений?
Да, Nano Banana Pro поддерживает генерацию и редактирование изображений. См. справочник по API редактирования изображений.
Почему возникает ошибка connection reset by peer / write_response_body_failed (500)?
Почему возникает ошибка connection reset by peer / write_response_body_failed (500)?
Полный текст ошибки выглядит так:Обычно эта ошибка вызвана загрузкой слишком больших изображений: тело запроса становится слишком объёмным, и соединение обрывается. Соблюдайте следующие рекомендации:
- Ограничьте количество изображений: не превышайте официальное ограничение (максимум 14 изображений на prompt) и не добавляйте слишком много изображений-образцов.
- Ограничьте размер каждого изображения: размер каждого изображения должен быть меньше 5 МБ. Официальное ограничение — 7 МБ на изображение, а кодирование в base64 увеличивает размер примерно на треть, поэтому оставьте запас.
- Сжимайте изображения на стороне клиента перед загрузкой: сжимайте изображения на стороне клиента (или на серверном реле) перед отправкой в API. Обычно ограничивают длину большей стороны, преобразуют изображение в JPEG/WebP и настраивают параметр качества.
- Перейдите на ввод URL: нативный формат Gemini поддерживает передачу URL изображения через
fileData.fileUri, что позволяет полностью избежать чрезмерно больших тел запросов с данными base64. См. руководство разработчика Nano Banana.