FLUX 3 Image API
FLUX 3 Image от Black Forest Labs доводит контроль генерации до пиксельного уровня: размещайте элементы через bounding box, редактируйте по зонам, пока остальное остаётся идентичным на уровне пикселей, и генерируйте нативно от 768sq до 4K. Roko API предоставляет его как асинхронную задачу от $0.041 за запрос 768sq.
- Публичный ID модели
flux-3-image- Уровни вывода
768sq / 1K / 1.5K / 2K / 4K (1K по умолчанию)- Биллинг
За запрос по разрешению- Эндпоинт
POST /v1/images/tasks- Снимок каталога
Что такое FLUX 3 Image?
FLUX 3 Image — модель генерации и редактирования изображений, выпущенная Black Forest Labs 1 октября 2026 года под лозунгом «контролируй каждый пиксель». Её отличие — раскладка по bounding box: холст абстрагируется в нормализованную сетку координат 0–1000, и в конце промпта вы очерчиваете каждый элемент рамкой с собственным описанием; результат соблюдает эти ограничения размещения.
Редактирование тоже идёт по рамкам: изменения готового изображения выполняются рамка за рамкой в несколько проходов, и всё за пределами изменённых рамок остаётся идентичным на уровне пикселей — ошибка repaint остаётся локальной. Модель принимает до 10 референсов (именованных по позиции в промпте) плюс grounding — обращение к вебу для уточнения промпта.
Roko сейчас открывает пять уровней разрешения (768sq, 1K, 1.5K, 2K, 4K) и 16 соотношений сторон с оплатой за запрос по выбранному разрешению ($0.041 на 768sq до $0.607 на 4K). На дату проверки значения совпадали с прайсом BFL, но списание Roko всегда определяется текущим каталогом проекта. Вызовы идут через асинхронные задачи: отправка, task_id, затем опрос.
Ключевые возможности
Раскладка по bounding box
Размещайте каждый элемент на нормализованной сетке координат и описывайте его по рамкам — генерация превращается из проблемы точности промпта в проблему раскладки.
Зональное редактирование
Правьте готовое изображение рамка за рамкой в несколько проходов; нетронутые области остаются идентичными на уровне пикселей, без дрейфа всей картинки.
Слияние 10 референсов
Комбинируйте до 10 референсов, называйте каждый по позиции в промпте — модель размещает и рендерит их вместе.
Нативный 4K и 16 пропорций
Пять нативных уровней от 768sq до 4K (~16,8 Мп) на 16 соотношений сторон — 4K сохраняет детали при увеличении.
Цены на API FLUX 3 Image
Цены берутся из текущего каталога Roko и списываются за запрос по выбранному разрешению. На дату проверки они совпадали с прайсом BFL, но цены и акции провайдера не определяют списание Roko; сверяйтесь с оценкой и итоговым расчётом Roko.
| Разрешение | Цена | Единица |
|---|---|---|
| 768sq | $0.041 | за изображение |
| 1k | $0.048 | за изображение |
| 1.5k | $0.07 | за изображение |
| 2k | $0.1 | за изображение |
| 4k | $0.607 | за изображение |
Примеры стоимости
Уровень по умолчанию — стандартная стоимость веб- и соцматериалов.
Нативный верхний уровень для печати и крупного формата; оплата за запрос, неудачные запросы не тарифицируются.
Параметры и поддерживаемый объём
Поля взяты из текущего публичного generation_config. Синтаксис рамок пишется в конце промпта (нормализованные координаты 0–1000); возможности вне формы подчиняются валидации запроса.
| Параметр | Значения | Примечания |
|---|---|---|
prompt | textarea | Опишите изображение, которое нужно создать, или изменения для референсов. · Обязательно |
images | url / base64 · 1–10 | Референсы можно передавать как URL или Base64; актуальный лимит указан в поле модели. · Опционально |
aspect_ratio | auto / 21:9 / 2:1 / 16:9 / 3:2 / 7:5 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 5:7 / 2:3 / 9:16 / 1:2 / 9:21 | Задаёт соотношение сторон; auto оставляет решение модели. · По умолчанию: auto · Опционально |
resolution | 768sq / 1k / 1.5k / 2k / 4k | Выбирает доступный для модели уровень разрешения; значение может напрямую влиять на цену. · По умолчанию: 1k · Опционально |
safety_tolerance | 0–4 | Roko сейчас принимает 0–4: 0 — самый строгий уровень, 4 — самый свободный; по умолчанию 2. · По умолчанию: 2 · Опционально |
grounding | boolean | Если включено, модель может обращаться к вебу для уточнения промпта; включено по умолчанию. · По умолчанию: true · Опционально |
Вызов FLUX 3 Image через Roko API
Работайте через асинхронные задачи: отправьте задачу, получите task_id, затем опросите результат. Не exposing ключ API в клиентском коде.
Отправить генерацию
curl https://api.rokoapi.com/v1/images/tasks \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
-d '{
"model": "flux-3-image",
"prompt": "Modern city park poster: bounding boxes — fountain center (400,500)-(600,800), skyscrapers background left (0,0)-(350,700), oak trees background right (650,100)-(1000,750)",
"aspect_ratio": "16:9",
"resolution": "1k"
}'Запросить задачу восстановления
curl https://api.rokoapi.com/v1/tasks/$TASK_ID \
-H "Authorization: Bearer $API_KEY"POST /v1/images/tasks возвращает 202 с task_id; после завершения генерации запрашивайте GET /v1/tasks/{task_id} для результата или причины сбоя. Idempotency-Key должен быть уникальным; повтор с тем же ключом возвращает исходную задачу без повторного списания.
Подходящие сценарии
Точные раскладки и постеры
Заголовки, объекты и фон подчиняются рамкам — рекламные макеты и вёрстка постеров.
Poster: product bottle center, headline text box top-left, lifestyle scene bottom — each element in its own bounding box.
Многопроходная локальная доработка
Правьте по рамкам при пиксельной стабильности окружения — для финалов с многократным согласованием.
Edit only the bounding box around the logo: replace with the new wordmark, keep everything else pixel-identical.
Синтез сцен из нескольких референсов
Сливайте людей, продукты и декорации из нескольких референсов в одно изображение, разложенное по рамкам.
Combine the model from image 1, the outfit from image 2, and the studio background from image 3 into one composition.
Печать 4K и крупный формат
Нативный 4K (~16,8 Мп) сохраняет детали при увеличении — стенды и печатные материалы.
Trade-show backdrop at 4K: brand hero center, product lineup along the bottom edge, clean gradient background.
Ограничения, которые важно знать
- Оплата за запрос, уровень 4K ($0.607) заметно дороже нижних — для массовых черновиков берите 768sq или 1K.
- Bounding box используют нормализованные координаты 0–1000 в конце промпта; при ошибке синтаксиса рамка обрабатывается как обычный текст или отклоняется валидацией.
- Roko сейчас ограничивает safety_tolerance диапазоном 0–4 (0 — самый строгий, 4 — самый свободный), значение по умолчанию — 2; перед повышением проверьте соответствие условиям.
- Отправленная задача — не успешная генерация: доверяйте результату опроса и проверяйте выдачу перед использованием.
FLUX 3 Image или другая модель изображений?
FLUX 3 — для точной раскладки и зонального редактирования; семейство Seedream — для китайскоязычных сцен и серий; GPT Image 2.5 — для прозрачных фонов и повседневного контента. Взвешивайте гранулярность контроля, разрешение и цену.
Все модели →FAQ по FLUX 3 Image
Какой ID модели использовать для FLUX 3 Image?
Используйте публичный ID Roko API — flux-3-image, как указано, в поле model.
Сколько стоит FLUX 3 Image API?
Оплата за запрос по выбранному разрешению: $0.041 на 768sq, $0.048 на 1K, $0.07 на 1.5K, $0.10 на 2K, $0.607 на 4K. На дату проверки значения совпадали с прайсом BFL, но списание Roko определяется оценкой проекта и итоговым расчётом при отправке.
Как работает раскладка по рамкам?
Официальная схема нормализует холст на 0–1000 и размещает в конце промпта рамку с описанием для каждого элемента, например «fountain (400,500)-(600,800)». Результат соблюдает эти ограничения размещения.
Что такое зональное редактирование?
Вы правите готовое изображение рамка за рамкой: перерисовывается только зона внутри рамки, остальное остаётся идентичным на уровне пикселей; итерации можно вести в несколько проходов без дрейфа всей картинки.
Какие разрешения и пропорции поддерживаются?
Roko сейчас открывает уровни 768sq, 1K, 1.5K, 2K и 4K плюс 16 соотношений сторон (auto по умолчанию). 4K — это около 16,8 мегапикселей, нативный рендер, а не апскейл.
Через какой эндпоинт вызывать FLUX 3 Image?
Отправляйте асинхронные задачи через POST /v1/images/tasks, получайте task_id и опрашивайте GET /v1/tasks/{task_id} для результата или причины сбоя.
Зачем нужен параметр grounding?
С включённым grounding модель может обращаться к вебу для уточнения промпта (актуальные факты, описания брендовых материалов). По умолчанию включено; при ненадобности отключите явно.
Можно ли использовать открытые веса?
На момент последней проверки (06.10.2026) BFL обещает открытые веса «в ближайшие недели»; коммерческие веса требуют отдельной лицензии. На Roko запросы идут через официальный API-канал BFL.