FLUX 3 Image позволяет описать расположение отдельных элементов, используя прямоугольники в текстовом запросе к изображению. Система также редактирует референсное изображение: для каждого элемента можно задать исходное положение, новое положение и описание желаемого изменения. Black Forest Labs добавила конечную точку генерации изображений в примечания к выпуску от 1 октября 2026 года.
Для дизайнеров и авторов важно различать планирование всей композиции и изменение элемента в существующем изображении. В этом руководстве объясняется, как выбрать между этими подходами, перевести прямоугольник в нужные координаты и получить результат через API. Это руководство основано только на документации, проверенной 3 октября 2026 года. BIG CHANGE не создавал и не редактировал изображения с помощью продукта.
Главное изменение
- Что изменилось: В октябрьском выпуске BFL описаны создание композиции и редактирование через
v1/flux-3-image. Для этого в одном запросе объединяются описание сцены и таблица элементов JSON, а прямоугольники задают расположение или изменения. Примечания к выпуску BFL - Почему это важно: Авторы могут преобразовать запланированный прямоугольник в координаты, а затем указать, какие элементы референса оставить, переместить или заменить. Практический выбор — насколько подробно задавать результат: описать всю композицию, дать простую инструкцию или приложить явную таблицу редактирования. Руководство BFL по блокам
- За чем следить: До отправки запроса выберите разрешение и бюджет: указанные цены для
1kи4kсоставляют $0.048 и $0.607 за изображение. Проверьте весь результат: элементы могут выходить за пределы блоков, а изменение может затронуть соседние участки освещения, тени или отражения. Цены BFL, ограничения редактирования
Выберите браузерный интерфейс или API
На странице продукта BFL описаны два способа работы: нарисовать блоки в браузерном Playground или отправить запрос на компоновку через API. В документации есть ссылка на Playground для работы без кода. Используйте браузерный вариант, если хотите нарисовать области прямо на изображении; выберите API, если нужно передать координаты в запросе и получить результат программно. Мы не проверяли текущие элементы управления Playground, поэтому ниже описан формат запроса из документации, а не последовательность нажатий кнопок в браузере.
Для работы через API создайте аккаунт BFL, добавьте кредиты и получите ключ в панели управления. Отправьте JSON-запрос с методом POST на адрес https://api.bfl.ai/v1/flux-3-image, указав Content-Type: application/json и передав ключ в заголовке x-key. Обязателен только параметр prompt. Руководство BFL по генерации, ценам и настройке
Не смешивайте FLUX 3 Image и FLUX 3 Dev: эти инструкции относятся к размещённой на серверах BFL конечной точке Image. На странице продукта Image предлагается приобрести коммерческую лицензию на веса модели через отдел продаж. В проверенных для этого руководства источниках не подтверждается возможность скачать веса FLUX 3 Image с открытой лицензией. Доступ к FLUX 3 Image
Решите, насколько подробно задавать изображение
Задача | Входные данные по документации | Используемый приём |
|---|---|---|
Создать новую композицию | Запрос с описанием сцены; при необходимости после него добавляется таблица элементов | |
Изменить конкретную деталь | Инструкция и одно референсное изображение | Иногда достаточно точного описания; проверьте расширенный запрос |
Выбрать элементы для редактирования | Инструкция, референсное изображение и таблица редактирования | Исходные блоки и блоки назначения; для сохраняемых элементов добавьте строки keep |
Объединить референсы | Запрос с пояснением роли каждого изображения и от 2 до 10 изображений | Укажите, из какого изображения берётся каждый объект, предмет или обстановка |
По словам BFL, при простом редактировании блок может автоматически добавиться при расширении запроса. Для явного управления передайте собственную таблицу. В обычной инструкции «изображение 1» означает первый референс; в строках редактирования этот референс обозначается как ref_image_0. Руководство BFL по редактированию
Референсы указываются в images как URL или данные base64, в виде строки или списка. Можно передать от 1 до 10 изображений размером от 256 × 256 пикселей до 16 мегапикселей каждое. По умолчанию параметр aspect_ratio равен auto: при наличии референса соотношение сторон берётся из первого изображения, а без него создаётся квадратное. Укажите параметр явно, если для макета нужна определённая форма. Обзор конечной точки BFL
Переведите прямоугольник в блок координат
Каждый блок задаётся как [top, left, bottom, right], целыми координатами от 0 до 1000. Сначала указываются вертикальные координаты. Каждая ось независимо охватывает всё изображение, поэтому координатная сетка растягивается под альбомный или портретный холст. Формат блоков BFL
Чтобы перевести пиксельные координаты, разделите верхнюю и нижнюю границы на высоту изображения, а левую и правую — на его ширину. Умножьте каждый результат на 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
Создайте новое изображение
Опишите всю композицию, обозначая элементы маркерами <id>. Добавьте массив JSON с параметрами id, bbox и desc для каждого элемента. Массив включается в текст параметра prompt, а не передаётся как отдельное поле верхнего уровня.
В документированном примере BFL с бегущим силуэтом фон занимает весь холст, а фигура находится в центральном блоке. Следующий сокращённый запрос повторяет схему композиции из примера; BIG CHANGE его не запускал:
{
"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 по композиции и ограничениям
Отредактируйте существующее изображение
Передайте исходник в images. В строках редактирования сохраняются id и desc, но вместо bbox используются следующие поля:
Операция | | | |
|---|---|---|---|
Оставить элемент | | Его исходный блок | Тот же блок |
Переместить или изменить размер | | Его исходный блок | Другой блок назначения |
Добавить, заменить или изменить цвет | | | Желаемый блок результата |
Удалить | | Его исходный блок | |
Объедините инструкцию и массив редактирования в параметр prompt, как при создании композиции. Описывайте добавления и удаления в обоих местах. Для элементов, которые должны остаться на месте, добавьте строки keep. В руководстве BFL сказано, что пиксели за пределами блоков обычно не меняются, однако могут измениться соседние участки освещения, отражения и тени. Перед подтверждением изменения сравните результат с исходным изображением целиком. BFL также сообщает, что в собственных тестах новые элементы в блоках размером около 40 × 25 пикселей часто не появлялись; это наблюдение поставщика, а не универсальный минимальный размер и не тест BIG CHANGE. Руководство BFL по редактированию, схема строк редактирования
Выберите разрешение и бюджет
В обзоре перечислены 768sq, 1k, 1.5k, 2k и 4k, причём по умолчанию используется 1k. На странице цен указаны следующие тарифы; цена для режима 1.5k не приведена. Перед использованием проверьте стоимость этого варианта. Обзор BFL
Разрешение | Указанный размер результата | Цена одного изображения | Стоимость десяти запросов, расчётная |
|---|---|---|---|
| 768 × 768 | $0.041 | $0.41 |
| Около 1 мегапикселя | $0.048 | $0.48 |
| Около 4 мегапикселей | $0.100 | $1.00 |
| Около 16 мегапикселей | $0.607 | $6.07 |
Это опубликованные BFL цены в долларах США, проверенные 3 октября. Стоимость десяти запросов рассчитана арифметически, это не фактические расходы. BFL указывает одинаковую цену для API и Playground; один кредит равен $0.01. Ответ на отправленный запрос содержит параметр cost. Запрос в режиме 4k стоит примерно в 12,6 раза дороже, чем в режиме 1k; выбирайте нужный размер результата и закладывайте бюджет на дополнительные попытки. Изменение разрешения требует нового запроса; это руководство не подтверждает, что два запроса дадут одинаковую композицию. Цены BFL
Необязательный параметр grounding по умолчанию имеет значение true, включая перед генерацией поиск в интернете и по изображениям. BFL утверждает, что отключение параметра ускоряет результат, используя только запрос. Мы не измеряли разницу в скорости и не проверяли точность результатов с поисковой привязкой. Документация BFL по поисковой привязке
Отправьте запрос, проверьте статус и сохраните результат
После отправки сохраните возвращённое значение polling_url и проверяйте статус именно по этому URL, передавая API-ключ. URL указывает на регион, в котором обрабатывается задача. Статусы Pending, Reasoning и Generating означают, что задача ещё выполняется. При статусе Ready, скачайте result.sample; подписанная ссылка истекает через час. Не передавайте заголовок x-key при скачивании по этой ссылке. В ответе также есть result.prompt, где показан расширенный запрос, и result.duration, время генерации. Инструкции BFL по получению результата
Для заблокированной или завершившейся ошибкой задачи нужны действия, отличающиеся от тех, что применяются к выполняющейся. Request Moderated означает, что заблокирован вход; Content Moderated означает, что заблокирован результат. Перед новой попыткой измените входные данные. При статусе Error изучите ответ; для неизвестной или просроченной задачи возвращается статус Task not found. BFL предупреждает, что ошибка может прийти со статусом HTTP 503 и обычным телом JSON, поэтому перед повторной попыткой проверьте его поле status. Слишком большие референсы вызывают ошибку 400; неизвестное поле, недопустимое значение, пустой запрос или слишком маленькое изображение могут вызвать 422. Параметры seed, width и input_image из других конечных точек здесь не поддерживаются. Руководство BFL по генерации и ошибкам
Работа завершена, когда результат сохранён и вы проверили его расположение, запрошенный текст и области вокруг отредактированного участка. Ответ со статусом Ready подтверждает, что результат доступен; соответствие задаче определяется визуальной проверкой.
Источники и материалы для дальнейшего чтения
- Страница продукта FLUX 3 Image: описывает браузерный интерфейс, API и коммерческий доступ к весам модели. Демонстрации принадлежат поставщику и не являются результатами наших тестов.
- Примечания к выпуску от 1 октября: указывают дату выпуска Image и описывают общую конечную точку. Широкие заявления об управлении сопоставляются с более узкими ограничениями в руководствах.
- Обзор конечной точки: содержит параметры, ограничения на референсы, варианты разрешения и поведение поиска с привязкой к источникам.
- Руководство по ограничивающим рамкам: объясняет две схемы строк и адаптированный выше пример с бегущим силуэтом.
- Руководство по редактированию: помогает с пересчётом координат и порядком референсов, а также описывает ограничения для небольших областей и соседних пикселей.
- Руководство по генерации: описывает аутентификацию, асинхронное получение результата, истекающие ссылки и ошибки.
- Цены: содержит тарифы, использованные в наших расчётах. Перед оплатой проверяйте цены и параметры запроса: это актуальная документация.
