Как использовать Nano Banana Pro/Nano Banana 2 API — пошаговое руководство для разработчиков

Если вы искали “Nano Banana Pro API”, то первое, что может сбить с толку, — это название. Название продукта — Nano Banana Pro. Название API, которое вы фактически используете в коде, — это gemini-3-pro-image. Как только это станет ясно, остальные этапы настройки уже не будут казаться такими загадочными.

Используйте Nano Banana Pro, когда изображение должно сохранять целостность: читаемый текст, детали продукта, упоминания бренда, локализованные макеты или визуальный бриф с множеством мелких ограничений. Если вы все еще пробуете десять вариантов одной и той же идеи, начните сначала с Nano Banana 2 и переходите к Pro, когда направление разработки оправдывает дополнительные затраты.

Если ваша команда по-прежнему занимается разработкой формулировок запросов, а не выпуском приложения, Рабочая среда Nano Banana Pro от GlobalGPT Это удобный инструмент для сравнения результатов до того, как разработчик подключится к официальному API. Это творческий способ упростить рабочий процесс, но он не заменяет консоль API Google, систему биллинга, журналы или средства корпоративного управления.

Краткий ответ

Чтобы использовать Nano Banana Pro через API, создайте проект в Google AI Studio или Google Cloud, сгенерируйте ключ API для Gemini, установите Google Gen AI SDK и вызовите gemini-3-pro-image. Начните с одного запроса на преобразование простого текста в изображение. Если вы по-прежнему проверяете доступ перед созданием API, то Пошаговое руководство по бесплатной пробной версии Gemini 3 Pro — полезное дополнение к основной книге.

Что на самом деле представляет собой API Nano Banana Pro

Nano Banana Pro — это премиальная собственная модель Google для генерации изображений из семейства Gemini. В документации для разработчиков Google называет её Gemini 3 Pro Изображение. Именно поэтому строка модели выглядит иначе, чем маркетинговое название.

API может генерировать изображение на основе текста, использовать одно или несколько эталонных изображений, а также редактировать существующее изображение в соответствии с письменными инструкциями. Благодаря этому оно полезно для создания макетов продуктов, вариантов рекламных объявлений, диаграмм, локализованных рекламных материалов, а также в рабочих процессах с изображениями, где текст внутри изображения должен оставаться читаемым; для экспериментов без программирования Генератор изображений GlobalGPT — это место, где проще всего сначала опробовать творческое направление.

Nano Banana Pro против Nano Banana 2

Выбор зависит не столько от того, какое название звучит более современно, сколько от того, на каком этапе работы вы находитесь. «Pro» — для тщательной проходки. «Nano Banana 2» — для беспорядочного цикла черновой проходки; если вам нужен именно этот более быстрый способ, прочитайте Руководство по 2 бесплатным пробным версиям Nano Banana прежде чем выстраивать весь рабочий процесс вокруг Pro.

Настройте API с использованием реальных точек входа

Для создания прототипа Google AI Studio, как правило, является самым быстрым способом. Для корпоративного приложения используйте инфраструктуру Google Cloud, которой ваша команда уже доверяет, особенно если вам требуются общий счет, контроль доступа, ведение журналов или управление Vertex AI. Если выбор доступа действительно зависит от тарифных планов Google, сравните все «за» и «против» в Руководство по сравнению версий Google AI Plus и Pro прежде чем считать настройку API единственной проблемой.

Публичная документация — это самый понятный первый шаг. С её помощью вы сможете убедиться, что находитесь на странице создания образа Nano Banana, проверить, используется ли на этой странице рекомендуемый путь к API Interactions, а также перейти оттуда к точкам входа для API-ключа или AI Studio.

1. Создайте или откройте проект в Google AI Studio или Google Cloud.
2. Создайте ключ API Gemini.
3. Сохраните ключ в виде переменной среды на стороне сервера.
4. Установите Google Gen AI SDK в свой бэкенд-проект.
5. Перед добавлением эталонных изображений или функций, предназначенных для пользователей, проведите одно тестирование с низким разрешением.

Страница с ключом API также является общедоступной, однако создание или просмотр ключа зависит от вашей учетной записи Google и прав доступа к проекту. Главное правило: не допускайте попадания этого ключа в JavaScript-код фронтенда. Браузер или мобильное приложение должны обращаться к вашему бэкенду, а ваш бэкенд — к Gemini.

После входа прямой URL-адрес AI Studio действительно открывается в Playground с Нано Банана Про выбран в качестве gemini-3-pro-image. В этом обзоре AI Studio также указала на одну практическую проблему с доступом: для запуска Nano Banana Pro в Playground требуется подписка на Google AI Plan или ключ API.

Сайт Получить код На данном этапе всё же стоит проверить эту кнопку. Она подтверждает, что вы находитесь в рабочем процессе разработчика, но если модель заблокирована для данной учетной записи, панель кода может открыться без полного готового к запуску фрагмента кода. Это сигнал о необходимости настройки, а не ошибка системы.

export GEMINI_API_KEY="YOUR_API_KEY"

Создать первое изображение

Первый запрос должен быть намеренно простым. Вы проверяете аутентификацию, доступ к модели, формат ответа и обработку файлов. Работа над сложными подсказками может подождать, пока система не наладится.

from google import genai
from google.genai import types
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=(
 "Создайте чистый макет туристической кружки из нержавеющей стали"
 "на белом столе. Добавьте читаемую надпись: MORNING LAB."
    ),
    config=types.GenerateContentConfig(
 response_modalities=["TEXT", "IMAGE"]
    ),
)

for part in response.candidates[0].content.parts:
    if part.text:
 print(part.text)
    elif part.inline_data:
 with open("nano-banana-pro-output.png", "wb") as f:
 f.write(part.inline_data.data)

В этом задании требуется создать простой макет продукта с разборчивым текстом. Это позволяет быстро оценить три важных аспекта, значимых в реальной работе: реалистичность объекта, композицию и способность модели четко отображать короткий текст. Чтобы адаптировать задание, не изменяя основных параметров, попробуйте использовать тот же бриф в Рабочая среда Nano Banana Pro от GlobalGPT первый.

Редактирование изображений со ссылками

Именно при редактировании с использованием эталонного изображения Nano Banana Pro начинает оправдывать свою цену. Вместо того чтобы запрашивать новое изображение с нуля, вы предоставляете модели исходное изображение и точно указываете, что можно изменить, а что должно остаться без изменений.

Если вы не являетесь разработчиком, воспринимайте этот блок как пример рабочего процесса, а не как код, который вам нужно запустить. Имя файла product-reference.png просто означает “имеющееся изображение вашего продукта”. Если ваша основная задача заключается в сравнении моделей изображений, то более широкое Тест альтернатив Gemini 3 Pro поможет вам решить, стоит ли тратить время на дополнительную настройку версии Pro.

from google import genai
from google.genai import types
from PIL import Image
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
reference = Image.open("product-reference.png")

response = client.models.generate_content(
    model="gemini-3-pro-image",
    contents=[
 reference,
 (
 "Сохраните форму кружки, ручку и расположение логотипа без изменений. "
            "Измените фон на светлую кухонную столешницу, добавьте тёплый утренний свет, "
 "и сделайте весь текст чётким и разборчивым."
 ),
    ],
    config=types.GenerateContentConfig(response_modalities=["TEXT", "IMAGE"]),
)

Хорошее задание на редактирование звучит почти как обратная связь для дизайнера: оставьте это, измените то, не перемещайте логотип, сохраните читаемость текста. Расплывчатые инструкции, такие как “сделайте это более престижным”, часто приводят к переделкам, поскольку оставляют модели слишком много места для догадок.

Ценообразование и контроль затрат

Прежде чем публиковать конкретные цифры по бюджету, ориентируйтесь на страницу с ценами Google как на достоверный источник информации. Согласно данным на 21 июля 2026 года, Google указывает тарифный план «Nano Banana Pro» в разделе «Gemini 3 Pro Image» и выделяет стоимость обработки текста и аналитических задач отдельно от стоимости генерации изображений.

Стоимость вывода изображений через API, данные на 21 июля 2026 года

Практическая схема расчета затрат проста: черновой вариант — дешевле, доработка — тщательно. Пусть Nano Banana 2 обрабатывает ранние варианты, а затем отправляйте самые сильные промты и ссылки в Nano Banana Pro для получения окончательных изображений. Также ограничивайте разрешение в зависимости от уровня пользователя и избегайте повторного генерации, если промт не изменился; если вам нужна линия черновой проработки со стороны продукта, Nano Banana 2 в GlobalGPT это более простой вариант, который стоит попробовать в первую очередь.

Примечания к производству

Как только пользователи получат возможность генерировать изображения с помощью вашего продукта, вам понадобятся меры безопасности. Использование API для работы с изображениями может быстро стать дорогостоящим, а причины сбоев должны объясняться без раскрытия конфиденциальных данных провайдера. Команды, которые еще решают, кому нужен платный доступ к ИИ, также могут сравнить рабочие процессы, основанные на подписке, в ChatGPT Руководство по составлению бизнес-плана.

• Храните ключи на стороне сервера: Не передавайте ключ API Gemini через браузер или мобильный клиент.
• Записывайте достаточно данных для отладки: идентификатор модели, хеш запроса, размер выходных данных, задержка, идентификатор пользователя и статус результата.
• Установить квоты: ограничить количество изображений на одного пользователя, рабочую область и расчетный период.
• Повторите попытку, соблюдая осторожность: Повторять попытки при временных сбоях, но не повторять попытки при ошибках, связанных с политиками или квотами, в цикле.
• Определите правила хранения: Узнайте, как долго вы храните сгенерированные изображения и загруженные исходные материалы.
• Выводите полезные сообщения об ошибках: сообщите пользователю, связана ли проблема с доступом, форматом файла, квотой или политикой запросов.

Где находит применение GlobalGPT

GlobalGPT лучше всего подходит для использования до или наряду со сборкой API. Разработчик может сравнить Nano Banana Pro с Нано-банан 2, GPT Image, Flux и другие модели обработки изображений в одном рабочем пространстве, а затем передать разработчику наиболее эффективный шаблон запроса.

Если вам нужны официальные ключи API, функции биллинга, журналы, корпоративный доступ или маршрутизация Vertex AI, продолжайте пользоваться платформой для разработчиков Google. Чтобы быстрее сравнивать варианты креатива и открывать меньше вкладок при разработке промптов, Рабочая область генератора изображений GlobalGPT может сделать ранние версии менее громоздкими.

ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ

Является ли Nano Banana Pro API тем же, что и Gemini 3 Pro Image?

Для разработчиков — да. В документации Google модель Nano Banana Pro обозначена как Gemini 3 Pro Image, а идентификатор модели в API — gemini-3-pro-image.

Что лучше выбрать: Nano Banana Pro или Nano Banana 2?

Используйте Nano Banana Pro для окончательных изображений, требующих более тщательного контроля, четкого текста, ссылок или соблюдения фирменного стиля. Используйте Nano Banana 2 для более быстрого создания черновых вариантов и экономичного цикла доработок.

Можно ли вызвать Nano Banana Pro напрямую из JavaScript-кода интерфейса?

Нет. Храните ключ API на стороне сервера, направляйте запросы через ваш бэкенд и применяйте пользовательские квоты перед отправкой запросов в API Gemini.

Заменяет ли GlobalGPT официальный API Google?

No. GlobalGPT удобен для оперативного тестирования и сравнения творческих решений на основе различных моделей, однако официальные ключи API, система биллинга, журналы и средства корпоративного управления доступны на платформе Google для разработчиков.

Как рассчитать расходы на использование API Nano Banana Pro?

Воспользуйтесь актуальной страницей Google с тарифами на API Gemini и произведите расчёт с учётом модели, выходного разрешения и объёма изображений. Распространённый подход к оптимизации затрат заключается в том, чтобы сначала создать черновой вариант с использованием более недорогой модели, а затем применить Nano Banana Pro для отдельных окончательных вариантов.