Black Forest Labs: FLUX.2 Pro

FLUX.2 [pro] — производственная модель изображений Black Forest Labs для создания по тексту и редактирования по референсам. Её документированный профиль сочетает фотореалистичные детали, управление текстом и цветом с общим пиксельным бюджетом референсов и результата и изображениями до 4 мегапикселей.

Ailoot Ultra · Картинки POST /v1/images/generations black-forest-labs/flux.2-pro

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

FLUX.2 [pro] — модель Black Forest Labs для генерации и редактирования изображений, ориентированная на производственную работу. Разработчик предлагает её как выбор по умолчанию для большинства визуальных задач FLUX.2: создать новое изображение по тексту или изменить сцену по визуальным референсам. Возможности семейства включают фотореалистичные материалы и свет, читаемый текст, указания точного цвета и постоянство объектов в связанных правках. Результат — изображение для товарной сцены, редакционной композиции, дизайн-концепции или визуальной коммуникации.

Подготовьте производственное задание

Начните с объекта, его действия или расположения, стиля и обстановки либо света. Руководство разработчика уделяет больше внимания первым словам и рекомендует ставить главный объект и действие перед декоративными деталями. Оно предлагает 10–30 слов для быстрых концепций, 30–80 для обычных проектов и более длинные описания для сложных сцен. Эти диапазоны — советы по написанию промптов, а не ограничение текстового контекста.

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

Руководство семейства документирует промпты на естественном языке и в структуре JSON. Структурированное описание сцены может разделять объект, фон, свет и композицию по полям, чтобы ясно менять отдельное требование. Также поддерживаются описания цвета в hex: привязывайте код к конкретному предмету или тексту. Позитивно описывайте нужный вид, поскольку документированный процесс промптинга FLUX.2 не предусматривает негативных промптов.

Редактирование по референсам и общий пиксельный бюджет

Конкретный профиль запроса [pro] предлагает восемь позиций референсных изображений; интерактивный интерфейс разработчика отдельно поддерживает десять. Назначьте каждой картинке роль: внешность объекта, одежда, дизайн товара, комната или стиль. Для существующей сцены укажите изменяемый элемент и сохраняемые композицию, окружение и визуальные детали. Опубликованные примеры включают композиции с мебелью, смену фона или погоды, замену предметов и правку текста.

Количество референсов также зависит от размера результата. Руководство [pro] разработчика задаёт общий бюджет входа и выхода 9 мегапикселей. В примерах допустимы восемь референсов при результате 1 мегапиксель и семь при 2 мегапикселях; с ростом результата вместимость референсов снижается. Планируйте исходный набор и результат совместно, не считая максимальное число позиций доступным при любом размере. Используйте референсы с необходимой информацией и обозначайте их вклад.

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

Расширение промпта и фиксированный профиль в сравнении с Preview

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

Документация различает обычную конечную точку [pro] как фиксированный снимок модели и [pro] Preview, куда вводятся последующие улучшения. Формы запросов и ответов одинаковы, но базовые веса различаются. Сохраняйте точный выбранный профиль вместе с изображением и референсами. Отдельная метка Preview не должна незаметно заменять обычный [pro], когда правка зависит от того же документированного выбора модели.

Размеры, форматы и выбранный материал

Руководство семейства документирует результат до 4 мегапикселей, явные размеры не менее 64×64 и кратность 16. Для большинства задач рекомендуется до 2 мегапикселей. Ширина и высота задают кадрирование: квадратный товарный снимок, вертикальный макет и широкая редакционная сцена по-разному распределяют пространство. Конкретный запрос перечисляет JPEG, PNG и WebP, по умолчанию JPEG, и необязательный seed.

Профиль [max] имеет отдельный поиск для привязки к источникам, [flex] предоставляет шаги сэмплирования и guidance, а [klein] — меньший профиль с четырьмя референсами. Выбирайте версию под задачу, не перенося эти настройки в [pro]. Для выбранного материала сохраняйте само изображение, конечный промпт, референсы, размеры и метку модели. Подписанные ссылки результатов FLUX.2 разработчика истекают через десять минут, поэтому получайте изображение, не полагаясь на временный адрес. Проверяйте идентичность объектов, цвета, текст, композицию и изменённые детали перед размещением в материалах для клиентов.

Ailoot Ultra · Картинки POST /v1/images/generations black-forest-labs/flux.2-pro

black-forest-labs/flux.2-pro

Black Forest Labs /black-forest-labs/flux.2-pro

Начало

Допустимые входные данные: Текст · Картинки
Результаты: Картинки

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Картинки POST /v1/images/generations

Входные данные: text, image
Результат: image

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения black-forest-labs/flux.2-pro	По умолчанию—
Поле`prompt`	Тип`string`	ТребованиеОбязательно	Значения и ограничения Минимальная длина: 1	По умолчанию—
Поле`aspect_ratio`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16, 21:9, auto	По умолчанию—
Поле`output_format`	Тип`string`	ТребованиеНеобязательно	Значения и ограничения png, jpeg	По умолчанию—
Поле`n`	Тип`integer`	ТребованиеНеобязательно	Значения и ограничения Минимум: 1 Максимум: 1	По умолчанию—
Поле`input_references`	Тип`array`	ТребованиеНеобязательно	Значения и ограничения Минимум элементов: 0 Максимум элементов: 8	По умолчанию—
Поле`provider`	Тип`object`	ТребованиеНеобязательно	Значения и ограничения	По умолчанию—

Параметры и жизненный цикл метода

Параметр	Контракт
Параметр`content_type`	Контрактapplication/json
Параметр`required`	Контрактmodel, prompt
Параметр`material_types`	Контрактtext, image

Жизненный цикл: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · Фактически возвращённый task_id или запись в медиатеке

GET /v1/media/assets/{asset_id}/content

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

Тарифы

Как рассчитывается итоговая плата

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

Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.

Быстрый режим: Не указано При выборе быстрого режима
Режим flex: Не указано При выборе режима flex
Максимальная интенсивность рассуждений: Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default)

Оценочные ставки для сравнения

Цены по конфигурациям

Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.

Конфигурация	Шкала ставок	Прогноз количества	Расчётная единица	Плата
КонфигурацияБазовые тарифы на токены	Шкала ставокБазовая ставка	Прогноз количества—	Расчётная единица—	Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов
Конфигурациямегапиксель выходного изображения	Шкала ставок—	Прогноз количества—	Расчётная единицаза мегапиксель выходного изображения	Плата Выход · мегапиксель выходного изображения · Оценка только для сравнения $0.06 за мегапиксель выходного изображения
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.06 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Картинки

curl

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'black-forest-labs/flux.2-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin

def save_images(items):
    if not items: raise SystemExit("No completed images; retain the full response")
    for index, item in enumerate(items):
        encoded=item.get("b64_json")
        uri=item.get("url", "")
        if not encoded and uri.startswith("data:image/"):
            header, separator, encoded=uri.partition(",")
            if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
        if encoded:
            raw=base64.b64decode(encoded,validate=True)
        elif uri:
            uri=urljoin("https://api.ailoot.ai",uri)
            parsed=urlsplit(uri)
            if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
                raise SystemExit("Invalid returned image URL")
            owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
            args=["curl","--fail-with-body","--silent","--show-error",uri]
            if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
            temporary=Path(f"image-{index}.bin")
            subprocess.run(args+["-o",str(temporary)],check=True)
            raw=temporary.read_bytes()
            temporary.unlink()
        else: raise SystemExit("Image has neither bytes nor URL")
        if not raw: raise SystemExit("Empty image result")
        ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
        Path(f"image-{index}.{ext}").write_bytes(raw)
    print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT

Получить и сохранить результаты

Ailoot Ultra · Картинки

Загрузите каждое полученное изображение или сохраните его содержимое Base64

GET /v1/media/tasks/{task_id}
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Чтение другого содержимого

Читать существующие материалы, принадлежащие вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.

Сохраняйте все готовые результаты

Сохраните каждое готовое изображение; загрузите содержимое по каждому полученному URL или декодируйте его содержимое Base64.

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

Если нужно проверить исходный ответ

Сохраните возвращённый X-Client-Request-ID для сверки. Читайте только фактически возвращённые значения task_id/asset_id или собственную медиатеку; никогда не составляйте URL задачи из ID операции и никогда не отправляйте запрос создания повторно.

Поля ответа

Поле	Тип
Поле`created`	Тип
Поле`data[].url`	Тип
Поле`data[].b64_json`	Тип
Поле`usage`	Тип

Псевдонимы

Псевдонимы моделей

Ailoot Ultra black-forest-labs/flux.2-pro

Псевдонимы путей метода

/v1/images

Связанные ID для вызова

black-forest-labs/flux.2-pro

FAQ · Black Forest Labs: FLUX.2 Pro

Какие входные данные и результаты доступны?: POST /v1/images/generations · black-forest-labs/flux.2-pro: text, image → image
Какие поля использует запрос?: POST /v1/images/generations · black-forest-labs/flux.2-pro: model, prompt, aspect_ratio, output_format, n, input_references, provider
Какие ограничения действуют?: POST /v1/images/generations · black-forest-labs/flux.2-pro: n.minimum: 1; n.maximum: 1

Black Forest Labs: FLUX.2 Pro