Версия Markdown
AI-translated from English; not yet reviewed by a fluent editor.
# FLUX 3 Image: руководство по блокам компоновки и точечному редактированию
> С помощью блоков компоновки и референсных изображений FLUX 3 Image позволяет задавать композицию или точечные изменения. В этом руководстве по документации рассматриваются координаты, получение результатов, цены и ограничения.
By BIG CHANGE Editorial
Published: 2026-10-03T04:10:59.237Z
Updated: 2026-10-03T04:10:59.237Z
Canonical: https://bigchange.ai/blog/flux-3-image-layout-editing-guide
AI-generated conceptual editorial illustration by BIG CHANGE.
FLUX 3 Image позволяет описать расположение отдельных элементов, используя прямоугольники в текстовом запросе к изображению. Система также редактирует референсное изображение: для каждого элемента можно задать исходное положение, новое положение и описание желаемого изменения. Black Forest Labs добавила конечную точку генерации изображений в [примечания к выпуску от 1 октября 2026 года](https://docs.bfl.ai/release-notes).
Для дизайнеров и авторов важно различать планирование всей композиции и изменение элемента в существующем изображении. В этом руководстве объясняется, как выбрать между этими подходами, перевести прямоугольник в нужные координаты и получить результат через API. Это руководство основано только на документации, проверенной 3 октября 2026 года. BIG CHANGE не создавал и не редактировал изображения с помощью продукта.
## Главное изменение
- **Что изменилось:** В октябрьском выпуске BFL описаны создание композиции и редактирование через `v1/flux-3-image`. Для этого в одном запросе объединяются описание сцены и таблица элементов JSON, а прямоугольники задают расположение или изменения. [Примечания к выпуску BFL](https://docs.bfl.ai/release-notes)
- **Почему это важно:** Авторы могут преобразовать запланированный прямоугольник в координаты, а затем указать, какие элементы референса оставить, переместить или заменить. Практический выбор — насколько подробно задавать результат: описать всю композицию, дать простую инструкцию или приложить явную таблицу редактирования. [Руководство BFL по блокам](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
- **За чем следить:** До отправки запроса выберите разрешение и бюджет: указанные цены для `1k` и `4k` составляют $0.048 и $0.607 за изображение. Проверьте весь результат: элементы могут выходить за пределы блоков, а изменение может затронуть соседние участки освещения, тени или отражения. [Цены BFL](https://docs.bfl.ai/quick_start/pricing), [ограничения редактирования](https://docs.bfl.ai/flux_3/flux3_image_layout)
## Выберите браузерный интерфейс или API
На [странице продукта BFL](https://bfl.ai/models/flux-3-image) описаны два способа работы: нарисовать блоки в браузерном Playground или отправить запрос на компоновку через API. В [документации есть ссылка на Playground](https://playground.bfl.ai) для работы без кода. Используйте браузерный вариант, если хотите нарисовать области прямо на изображении; выберите API, если нужно передать координаты в запросе и получить результат программно. Мы не проверяли текущие элементы управления Playground, поэтому ниже описан формат запроса из документации, а не последовательность нажатий кнопок в браузере.
Для работы через API создайте аккаунт BFL, добавьте кредиты и получите ключ в [панели управления](https://dashboard.bfl.ai). Отправьте JSON-запрос с методом `POST` на адрес `https://api.bfl.ai/v1/flux-3-image`, указав `Content-Type: application/json` и передав ключ в заголовке `x-key`. Обязателен только параметр `prompt`. [Руководство BFL по генерации](https://docs.bfl.ai/flux_3/flux3_image_generate), [ценам и настройке](https://docs.bfl.ai/quick_start/pricing)
Не смешивайте FLUX 3 Image и FLUX 3 Dev: эти инструкции относятся к размещённой на серверах BFL конечной точке Image. На странице продукта Image предлагается приобрести коммерческую лицензию на веса модели через отдел продаж. В проверенных для этого руководства источниках не подтверждается возможность скачать веса FLUX 3 Image с открытой лицензией. [Доступ к FLUX 3 Image](https://bfl.ai/models/flux-3-image)
## Решите, насколько подробно задавать изображение
| Задача | Входные данные по документации | Используемый приём |
| --- | --- | --- |
| Создать новую композицию | Запрос с описанием сцены; при необходимости после него добавляется таблица элементов | `bbox` для каждого элемента, расположение которого важно |
| Изменить конкретную деталь | Инструкция и одно референсное изображение | Иногда достаточно точного описания; проверьте расширенный запрос |
| Выбрать элементы для редактирования | Инструкция, референсное изображение и таблица редактирования | Исходные блоки и блоки назначения; для сохраняемых элементов добавьте строки keep |
| Объединить референсы | Запрос с пояснением роли каждого изображения и от 2 до 10 изображений | Укажите, из какого изображения берётся каждый объект, предмет или обстановка |
По словам BFL, при простом редактировании блок может автоматически добавиться при расширении запроса. Для явного управления передайте собственную таблицу. В обычной инструкции «изображение 1» означает первый референс; в строках редактирования этот референс обозначается как `ref_image_0`. [Руководство BFL по редактированию](https://docs.bfl.ai/flux_3/flux3_image_layout)
Референсы указываются в `images` как URL или данные base64, в виде строки или списка. Можно передать от 1 до 10 изображений размером от 256 × 256 пикселей до 16 мегапикселей каждое. По умолчанию параметр `aspect_ratio` равен `auto`: при наличии референса соотношение сторон берётся из первого изображения, а без него создаётся квадратное. Укажите параметр явно, если для макета нужна определённая форма. [Обзор конечной точки BFL](https://docs.bfl.ai/flux_3/flux3_image_overview)
## Переведите прямоугольник в блок координат
Каждый блок задаётся как `[top, left, bottom, right]`, целыми координатами от 0 до 1000. Сначала указываются вертикальные координаты. Каждая ось независимо охватывает всё изображение, поэтому координатная сетка растягивается под альбомный или портретный холст. [Формат блоков BFL](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#format)
Чтобы перевести пиксельные координаты, разделите верхнюю и нижнюю границы на высоту изображения, а левую и правую — на его ширину. Умножьте каждый результат на 1000 и округлите. В документации BFL приведён расчёт для холста 1920 × 1080:
| Граница | Положение в пикселях | Вычисление | Значение в сетке |
| --- | --- | --- | --- |
| Верхняя | 108 | 108 ÷ 1080 × 1000 | 100 |
| Левая | 384 | 384 ÷ 1920 × 1000 | 200 |
| Нижняя | 972 | 972 ÷ 1080 × 1000 | 900 |
| Правая | 1536 | 1536 ÷ 1920 × 1000 | 800 |
Таким образом, блок задаётся как `[100, 200, 900, 800]`. Его вертикальный диапазон — от 10% до 90% кадра, горизонтальный — от 20% до 80%. Этот расчёт показывает, почему перестановка ширины и высоты или указание левой координаты перед верхней меняет нужную область. Сохраняйте соотношение сторон, использованное при разработке макета. [Пересчёт координат BFL](https://docs.bfl.ai/flux_3/flux3_image_layout#send-a-request)
## Создайте новое изображение
Опишите всю композицию, обозначая элементы маркерами `<id>`. Добавьте массив JSON с параметрами `id`, `bbox` и `desc` для каждого элемента. Массив включается в текст параметра `prompt`, а не передаётся как отдельное поле верхнего уровня.
В документированном примере BFL с бегущим силуэтом фон занимает весь холст, а фигура находится в центральном блоке. Следующий сокращённый запрос повторяет схему композиции из примера; BIG CHANGE его не запускал:
```json
{
"prompt": "A black running silhouette <silhouette_1> on a chartreuse background <background_1>. [{\"id\":\"background_1\",\"bbox\":[0,0,1000,1000],\"desc\":\"Chartreuse background with paper texture\"},{\"id\":\"silhouette_1\",\"bbox\":[150,150,850,850],\"desc\":\"Black running silhouette with stippled texture\"}]",
"aspect_ratio": "1:1",
"resolution": "1k"
}
```
Если в макете есть текст, задавайте каждую строку отдельной записью и указывайте в параметре `desc` точные требуемые слова. Блоки задают расположение и масштаб, но BFL предупреждает, что элемент может выходить за их пределы. Это не жёсткие маски обрезки. [Руководство BFL по композиции и ограничениям](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes)
## Отредактируйте существующее изображение
Передайте исходник в `images`. В строках редактирования сохраняются `id` и `desc`, но вместо `bbox` используются следующие поля:
| Операция | `from` | `src_bbox` | `tgt_bbox` |
| --- | --- | --- | --- |
| Оставить элемент | `"ref_image_0"` | Его исходный блок | Тот же блок |
| Переместить или изменить размер | `"ref_image_0"` | Его исходный блок | Другой блок назначения |
| Добавить, заменить или изменить цвет | `null` | `null` | Желаемый блок результата |
| Удалить | `"ref_image_0"` | Его исходный блок | `null` |
Объедините инструкцию и массив редактирования в параметр `prompt`, как при создании композиции. Описывайте добавления и удаления в обоих местах. Для элементов, которые должны остаться на месте, добавьте строки keep. В руководстве BFL сказано, что пиксели за пределами блоков обычно не меняются, однако могут измениться соседние участки освещения, отражения и тени. Перед подтверждением изменения сравните результат с исходным изображением целиком. BFL также сообщает, что в собственных тестах новые элементы в блоках размером около 40 × 25 пикселей часто не появлялись; это наблюдение поставщика, а не универсальный минимальный размер и не тест BIG CHANGE. [Руководство BFL по редактированию](https://docs.bfl.ai/flux_3/flux3_image_layout), [схема строк редактирования](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes#edit-an-image-box-by-box)
## Выберите разрешение и бюджет
В обзоре перечислены `768sq`, `1k`, `1.5k`, `2k` и `4k`, причём по умолчанию используется `1k`. На странице цен указаны следующие тарифы; цена для режима `1.5k` не приведена. Перед использованием проверьте стоимость этого варианта. [Обзор BFL](https://docs.bfl.ai/flux_3/flux3_image_overview)
| Разрешение | Указанный размер результата | Цена одного изображения | Стоимость десяти запросов, расчётная |
| --- | --- | --- | --- |
| `768sq` | 768 × 768 | $0.041 | $0.41 |
| `1k` | Около 1 мегапикселя | $0.048 | $0.48 |
| `2k` | Около 4 мегапикселей | $0.100 | $1.00 |
| `4k` | Около 16 мегапикселей | $0.607 | $6.07 |
Это опубликованные BFL цены в долларах США, проверенные 3 октября. Стоимость десяти запросов рассчитана арифметически, это не фактические расходы. BFL указывает одинаковую цену для API и Playground; один кредит равен $0.01. Ответ на отправленный запрос содержит параметр `cost`. Запрос в режиме `4k` стоит примерно в 12,6 раза дороже, чем в режиме `1k`; выбирайте нужный размер результата и закладывайте бюджет на дополнительные попытки. Изменение разрешения требует нового запроса; это руководство не подтверждает, что два запроса дадут одинаковую композицию. [Цены BFL](https://docs.bfl.ai/quick_start/pricing)
Необязательный параметр `grounding` по умолчанию имеет значение `true`, включая перед генерацией поиск в интернете и по изображениям. BFL утверждает, что отключение параметра ускоряет результат, используя только запрос. Мы не измеряли разницу в скорости и не проверяли точность результатов с поисковой привязкой. [Документация BFL по поисковой привязке](https://docs.bfl.ai/flux_3/flux3_image_overview#ground-the-prompt)
## Отправьте запрос, проверьте статус и сохраните результат
После отправки сохраните возвращённое значение `polling_url` и проверяйте статус именно по этому URL, передавая API-ключ. URL указывает на регион, в котором обрабатывается задача. Статусы `Pending`, `Reasoning` и `Generating` означают, что задача ещё выполняется. При статусе `Ready`, скачайте `result.sample`; подписанная ссылка истекает через час. Не передавайте заголовок `x-key` при скачивании по этой ссылке. В ответе также есть `result.prompt`, где показан расширенный запрос, и `result.duration`, время генерации. [Инструкции BFL по получению результата](https://docs.bfl.ai/flux_3/flux3_image_generate#results-and-errors)
Для заблокированной или завершившейся ошибкой задачи нужны действия, отличающиеся от тех, что применяются к выполняющейся. `Request Moderated` означает, что заблокирован вход; `Content Moderated` означает, что заблокирован результат. Перед новой попыткой измените входные данные. При статусе `Error` изучите ответ; для неизвестной или просроченной задачи возвращается статус `Task not found`. BFL предупреждает, что ошибка может прийти со статусом HTTP `503` и обычным телом JSON, поэтому перед повторной попыткой проверьте его поле `status`. Слишком большие референсы вызывают ошибку `400`; неизвестное поле, недопустимое значение, пустой запрос или слишком маленькое изображение могут вызвать `422`. Параметры `seed`, `width` и `input_image` из других конечных точек здесь не поддерживаются. [Руководство BFL по генерации и ошибкам](https://docs.bfl.ai/flux_3/flux3_image_generate)
Работа завершена, когда результат сохранён и вы проверили его расположение, запрошенный текст и области вокруг отредактированного участка. Ответ со статусом `Ready` подтверждает, что результат доступен; соответствие задаче определяется визуальной проверкой.
## Источники и материалы для дальнейшего чтения
- [Страница продукта FLUX 3 Image](https://bfl.ai/models/flux-3-image): описывает браузерный интерфейс, API и коммерческий доступ к весам модели. Демонстрации принадлежат поставщику и не являются результатами наших тестов.
- [Примечания к выпуску от 1 октября](https://docs.bfl.ai/release-notes): указывают дату выпуска Image и описывают общую конечную точку. Широкие заявления об управлении сопоставляются с более узкими ограничениями в руководствах.
- [Обзор конечной точки](https://docs.bfl.ai/flux_3/flux3_image_overview): содержит параметры, ограничения на референсы, варианты разрешения и поведение поиска с привязкой к источникам.
- [Руководство по ограничивающим рамкам](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes): объясняет две схемы строк и адаптированный выше пример с бегущим силуэтом.
- [Руководство по редактированию](https://docs.bfl.ai/flux_3/flux3_image_layout): помогает с пересчётом координат и порядком референсов, а также описывает ограничения для небольших областей и соседних пикселей.
- [Руководство по генерации](https://docs.bfl.ai/flux_3/flux3_image_generate): описывает аутентификацию, асинхронное получение результата, истекающие ссылки и ошибки.
- [Цены](https://docs.bfl.ai/quick_start/pricing): содержит тарифы, использованные в наших расчётах. Перед оплатой проверяйте цены и параметры запроса: это актуальная документация.
## Sources
- [FLUX 3 Image](https://bfl.ai/models/flux-3-image) — Описывает работу через браузер и API, а также коммерческий доступ к весам модели. Демонстрации являются материалами поставщика, а не нашими тестами. В проверенных источниках не подтверждена загрузка весов Image с открытой лицензией.
- [Обзор FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_overview) — Содержит параметры, ограничения на референсы, варианты разрешения и поведение поиска с привязкой к источникам.
- [Компоновка и редактирование FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_layout) — Подтверждает пересчёт координат, порядок референсов и ограничения для небольших областей и соседних пикселей.
- [Генерация FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_generate) — Описывает аутентификацию, асинхронное получение результата, истекающие ссылки и ошибки.
- [Примечания к выпуску](https://docs.bfl.ai/release-notes) — Указывают дату выпуска Image и описывают общую конечную точку. Широкие заявления об управлении рассматриваются с учётом более узких ограничений в руководствах.
- [Цены](https://docs.bfl.ai/quick_start/pricing) — Содержат тарифы, использованные в расчётах. Перед оплатой запроса нужно повторно проверить цены и параметры, поскольку это обновляемые документы.
- [Блоки компоновки FLUX 3 Image](https://docs.bfl.ai/flux_3/flux3_image_bounding_boxes) — Объясняет две схемы строк и адаптированный выше пример с бегущим силуэтом.