Архитектурный рендеринг с FLUX 3 Image: от текста к изображению, редактирование и референсы

FLUX 3 Image — это компонент генерации и редактирования изображений семейства FLUX 3 от Black Forest Labs, который через единый API-эндпоинт обеспечивает генерацию изображений из текста, редактирование существующих изображений, объединение нескольких референсных изображений и контроль композиции с помощью bounding box. Это руководство пошагово объясняет эти четыре базовых сценария для тех, кто хочет создавать архитектурные презентационные изображения и визуализации интерьеров.

Что вы узнаете

Следуя этому руководству, вы увидите, как создать архитектурный экстерьер или интерьер с нуля с помощью текста, как изменить только определённую деталь на рендере (материал, свет, мебель), как объединить фотографию объекта с референсным объектом и как закрепить положение каждого элемента композиции с помощью bounding box.

Требования

• API-ключ Black Forest Labs (передаётся в заголовке запроса как x-key)

• Доступ к эндпоинту POST https://api.bfl.ai/v1/flux-3-image; единственный обязательный параметр — prompt

• Для использования референсов — от 1 до 10 изображений (URL или base64, от 256×256 пикселей до 16 МП)

• Выбор aspect_ratio (различные соотношения от 21:9 до 9:21 или auto)

• Выбор resolution: 768sq, 1k, 1.5k, 2k или 4k

• Информация о параметрах safety_tolerance (0 — самый строгий, 4 — самый мягкий, по умолчанию 2) и grounding (по умолчанию включён)

Пошаговое использование

1. Генерация изображения из текста

Чтобы создать архитектурную сцену с нуля, нужно чётко описать сюжет, пространство, освещение и кадрирование. FLUX 3 Image создаёт всю сцену из одного промпта.

Contemporary single-family house exterior at golden hour, board-formed concrete facade, large glazed corner window, cantilevered wooden canopy, landscaped garden in foreground, soft warm sunlight, photorealistic architectural visualization, wide-angle framing

Поскольку этот промпт одновременно задаёт материалы (бетон, стекло, дерево), состояние освещения (закат) и кадрирование (широкий угол), он помогает модели последовательно выстроить сцену.

2. Редактирование существующего изображения

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

Change the facade cladding material from board-formed concrete to vertical timber slats, keep the window layout, lighting, and landscaping unchanged

Такой подход подходит офисам, которые хотят протестировать только одну переменную, например материал фасада, сохранив при этом ту же композицию.

3. Объединение нескольких референсных изображений

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

Use image 1 as the existing living room interior and image 2 as the armchair reference. Place the armchair from image 2 into the corner of the room shown in image 1, matching the room's existing light and perspective

Эту технику можно использовать, чтобы реалистично разместить изображение мебели из каталога, присланного клиентом, в существующей фотографии интерьера.

4. Контроль композиции с помощью bounding box

Bounding box, добавляемые в конец промпта, определяют положение каждого элемента на сцене координатами [верх, лево, низ, право] в сетке от 0 до 1000. Те же рамки можно использовать для перекраски, перемещения или удаления только одной части сцены (например, одного предмета мебели).

Open-plan office interior with a reception desk and a seating area. Reception desk at [100, 50, 400, 500]. Seating area with two armchairs at [450, 550, 850, 950]

Благодаря bounding box дизайнер может напрямую контролировать на этапе генерации изображения расположение, близкое к плановой схеме.

5. Использование параметра grounding

Grounding по умолчанию включён, и модель выполняет поиск в интернете, чтобы точнее воспроизводить реальные объекты; при отключении (grounding: false) результат генерируется быстрее, основываясь только на тексте промпта. Если важна точность конкретного продукта или бренда, grounding стоит оставить включённым; для быстрых концептуальных экспериментов его можно отключить.

Частые ошибки

• Генерация без указания aspect ratio; при отсутствии референса модель переходит к соотношению 1:1, что может не подойти для широких экстерьерных кадров.

• Отсутствие указания, что не должно меняться, в промптах редактирования; в этом случае модель может изменить больше элементов, чем нужно.

• Указание координат bounding box в масштабе, отличном от сетки 0-1000, вместо пикселей.

• Попытка скачать результат до того, как поле status через polling_url станет Ready, или попытка получить результат после истечения часового окна для скачивания.

• Нагромождение множества референсных изображений (до 10) в одном промпте без ссылок друг на друга; необходимо явно указывать позицию каждого изображения.

Следующие шаги

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

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

Это руководство адаптировано на основе информации о параметрах и эндпоинтах из официальной документации API Black Forest Labs (docs.bfl.ai, FLUX 3 Image Overview), а также общих описаний возможностей с официальных страниц продукта компании (bfl.ai); примеры промптов написаны оригинально для архитектурных и интерьерных сценариев использования.