Архитектурная визуализация с Nano Banana: API, промпты и редактирование

Что вы узнаете из этого руководства?

В руководстве рассказывается, как использовать Nano Banana через Gemini API для создания архитектурных изображений и редактирования референсов. Задача не в том, чтобы воспринимать модель как BIM- или 3D-пакет, а в том, чтобы визуализировать дизайн-идею, исследовать варианты атмосферы и запрашивать текстовые изменения для уже существующего изображения.

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

Требования и выбор модели

В исходной документации показаны доступ к Gemini API и сценарий взаимодействия с ним. В примере на Python используется клиент genai из пакета google; REST-пример передаёт API-ключ в заголовке x-goog-api-key. В этом материале документация не указывает необходимую версию SDK, стоимость или условия доступа к API. Прежде чем приступать к разработке, проверьте актуальную документацию API.

В списке моделей Google есть несколько вариантов семейства Nano Banana. В документации Nano Banana 2.1 рекомендуется для новых проектов; идентификатор модели — gemini-nano-banana-2.1. Nano Banana 2 указан под идентификатором gemini-3.1-flash-image. Nano Banana 2 Lite предназначен для задач, где важны скорость и стоимость; в источнике отмечено, что эта модель не оптимизирована для нескольких референсных изображений или последовательного многошагового редактирования. Для самых сложных задач с изображениями предусмотрена Nano Banana Pro с идентификатором gemini-3-pro-image.

Старые модели Imagen отключены в Gemini API. В примечании о переходе Google рекомендует использовать вместо Imagen модели Nano Banana, а для генерации изображений — метод generate_content вместо generate_images. В новых примерах API для Nano Banana показан сценарий interactions.create. Поэтому вместо попыток запустить старый код используйте метод, описанный в актуальной документации выбранной модели.

Генерация изображений: пошаговая инструкция

1. Определите цель работы. Для первой попытки выберите один тип результата — например, концептуальный кадр интерьера. Укажите в промпте тип пространства, ракурс, дневной свет и основные характеристики материалов. Вместо того чтобы просить сразу множество вариантов, сначала посмотрите на результат, а затем сформулируйте новый запрос на редактирование.

2. Выберите модель и способ работы с API. В примере на Python из документации клиент создаётся с помощью genai.Client(), после чего вызов interactions.create получает идентификатор модели и текстовый запрос. Данные сгенерированного изображения извлекаются из interaction.output_image.data, декодируются из Base64 и записываются в файл. Пример ниже следует описанной структуре; перед запуском убедитесь, что в вашей среде настроены доступ к API и Python-клиент.

from google import genai
import base64

client = genai.Client()
prompt = "Create a photorealistic architectural visualization of a compact contemporary apartment living room, viewed from the entrance. Pale oak cabinetry, warm off-white plaster walls, soft overcast daylight, restrained furniture, realistic material textures, no people."

interaction = client.interactions.create(
    model="gemini-nano-banana-2.1",
    input=prompt,
)

with open("ic-mekan-konsept.png", "wb") as image_file:
    image_file.write(base64.b64decode(interaction.output_image.data))

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

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

Create a photorealistic architectural visualization of a small contemporary library reading room, eye-level wide view from the entrance. Built-in pale oak bookshelves, a long communal table, matte mineral plaster walls, soft north-facing daylight, calm neutral palette, believable architectural proportions, no people, no text.

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

1. Отредактируйте референс текстовым запросом. В документации показан сценарий, в котором вместе с текстом передаётся изображение: можно попросить что-либо добавить или убрать, изменить стиль либо скорректировать цвет. Перед загрузкой изображения убедитесь, что у вас есть права на его использование. Промпт ниже предназначен для изменения атмосферы существующего изображения комнаты; передайте его в API вместе с редактируемым изображением.

Using the provided interior reference image, keep the room layout and camera viewpoint recognizable. Change the lighting to soft late-afternoon daylight and make the wall finish warm lime plaster. Preserve the existing furniture arrangement; do not add people or text.

Здесь требуется сохранить существующую планировку; всё же сравните результат с референсом и проверьте, не изменились ли геометрия и мебель. Нет гарантии, что модель точно сохранит каждую запрошенную деталь, поэтому такой метод не следует считать способом технической правки или обновления модели с точными размерами.

1. Улучшайте результат в следующем раунде. В документации Nano Banana описаны диалоговая работа с изображениями и последовательное редактирование, однако модели различаются по пригодности для многошаговой обработки. Nano Banana 2 Lite не оптимизирована для такого последовательного редактирования. Если нужно дорабатывать результат шаг за шагом, выбирайте модель с учётом этого различия.

In the current interior image, reduce the visual prominence of the ceiling lights and make the daylight feel softer. Keep the room composition, furniture positions, and material palette otherwise unchanged.

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

Типичные ошибки

• Использовать старый сценарий Imagen: Google сообщает, что модели Imagen отключены в Gemini API. Вместо старых идентификаторов моделей и прежнего метода генерации пользуйтесь актуальной документацией Nano Banana.

• Пытаться уместить всё в один промпт: большое число несвязанных изменений затрудняет оценку результата. Сначала сформируйте основную идею пространства, а затем отдельно измените освещение или материал.

• Не учитывать права на референсное изображение: Google прямо напоминает, что пользователь должен иметь права на загружаемые изображения. Проверьте это, прежде чем использовать проектные изображения, фотографии или другие референсы.

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

Как использовать Nano Banana в архитектурном и интерьерном проектировании?

Архитекторы, интерьерные дизайнеры и команды визуализации могут рассматривать Nano Banana для поиска идей на ранней стадии, изучения вариантов атмосферы и творческих экспериментов с уже существующими изображениями. Генерация по тексту и редактирование с изображением через API позволяют встроить такие визуальные эксперименты в текущий рабочий процесс. Однако источники не указывают на наличие плагина для конкретного 3D-пакета, обмена файлами или прямой совместимости.

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

Что делать дальше

Сначала создайте концепт по одному текстовому запросу, затем попробуйте отредактировать то же изображение, изменив освещение или материал. Если инструмент будет использоваться командой, сохраняйте идентификатор модели и промпт в рабочих заметках. Перед загрузкой изображений реальных людей или организаций проверьте права на их использование; поскольку методы API и набор моделей могут меняться, перед внедрением ещё раз изучите актуальную документацию.

Источник и лицензия

Примечание о переходе с Imagen и руководство по генерации изображений Nano Banana от Google AI for Developers распространяются по лицензии CC BY 4.0. Это руководство подготовлено на основе сведений об API и моделях из указанных документов, адаптированных на турецкий язык, и дополнено новыми примерами промптов для архитектурных задач.