Архитектурная генерация изображений с Nano Banana 2.1: API и промпты

Чему вы научитесь в этом руководстве?

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

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

Что потребуется

В документации Google по Gemini API для Nano Banana 2.1 используется название модели gemini-nano-banana-2.1. В примере на Python из источника применяется клиент google.genai; для генерации изображений понадобятся доступ к Gemini API, API-ключ и среда Python с установленным клиентом. Поскольку источник не указывает, как получить необходимый доступ к API или установить клиент, здесь не приводятся конкретный способ установки или версия пакета.

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

Пошагово: создайте архитектурное изображение по тексту

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

2. Опишите пространство и атмосферу. Укажите назначение, желаемый характер материалов и освещения, а также ракурс. Ниже приведён оригинальный пример промпта для интерьерной концептуальной визуализации:

Create an architectural concept image of a quiet reading room in a small urban library. Show a long oak reading table, built-in bookshelves, pale stone flooring, and soft daylight entering from a tall side window. Use a calm, restrained material palette and a human-eye-level wide interior view. Focus on spatial atmosphere and clear circulation.

Детали в промпте описывают замысел, который должен быть отражён в изображении. Это не параметр API, а инструкция модели на естественном языке. Проверьте материалы, масштаб и пространственные связи в результате, а в следующей попытке подробнее опишите только те элементы, которые хотите изменить.

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

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

Create an architectural visualization of a compact home office in a renovated apartment. Include a simple timber desk, built-in storage, a reading chair, and a large window. Emphasize soft overcast daylight, muted natural materials, and an uncluttered composition. Show the complete room from a human-eye-level interior viewpoint.

В этом примере описание мебели и пространства сочетается с заданием атмосферы и ракурса. Если одновременно менять множество параметров, будет сложнее понять, какие формулировки повлияли на результат. Поэтому полезнее вносить изменения небольшими шагами — так варианты будет проще сравнивать.

Редактирование референсного изображения с помощью текста

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

В качестве промпта для редактирования можно использовать пример ниже вместе с интерьерным изображением, права на использование которого у вас есть:

Using the provided interior image as a reference, explore a warmer material direction for the room. Keep the overall spatial layout and camera viewpoint recognizable. Shift the atmosphere toward soft late-afternoon daylight, with warmer timber accents and a calm, understated interior mood.

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

Типичные ошибки и дальнейшие шаги

• Расплывчатое описание пространства: формулировка «современный интерьер» сама по себе не задаёт назначение и атмосферу. Чётко укажите тип помещения, ключевые элементы изображения и ракурс.

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

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

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

В следующих попытках подготовьте несколько отдельных промптов для одного пространства, меняя только описание освещения, материалов или ракурса. Для получения данных изображения из ответа API используйте поле output_image и декодирование base64, как в официальном примере. За сведениями о дополнительных входных изображениях, поддерживаемых MIME-типах и подробностях работы с API обратитесь к официальной документации по визуальному анализу и генерации изображений.

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

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

Материал основан на руководствах Google по генерации изображений в Gemini API и переходу с Imagen. Оба источника распространяются по лицензии CC BY 4.0; материал адаптирован на турецкий язык и переработан с использованием оригинальных промптов для архитектурных и интерьерных рабочих процессов. Для примеров исходного кода указана лицензия Apache 2.0.