Black Forest Labs: FLUX.2 Max

FLUX.2 [max] — модель изображений Black Forest Labs для требовательных итоговых материалов и согласованных правок. Документированный профиль объединяет визуальные референсы, подробное управление сценой и привязку к веб-источникам для актуальных объектов; результат — до 4 мегапикселей.

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

О модели

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

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

Реальная информация и визуальное задание

Разработчик документирует веб-поиск для тем вроде текущей погоды, недавнего спортивного события или исторической обстановки. Укажите реальные место, событие и время, относящиеся к картинке, затем отдельно опишите художественную обработку. Концепция погодной карточки с привязкой к источникам может задавать город, отображаемое состояние погоды, точный заголовок и макет. Поиск информирует генерацию; прежде чем использовать красивую иллюстрацию для передачи фактов, нужно проверить видимые сведения по соответствующему источнику.

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

Референсы для требовательных правок

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

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

Текст, цвета и интерпретация промпта

Руководство FLUX.2 рекомендует структуру «объект–действие–стиль–контекст» с важными элементами в начале. Предлагаются 10–30 слов для быстрых концепций, 30–80 для обычных проектов и более длинные описания сложных сцен. Это рекомендации по письму, а не жёсткие пределы контекста. Естественный язык и структурированные JSON-описания — документированные способы организации объектов, размещения, света и стиля. Структурированный промпт является заданием для изображения, а не обещанием структурированного текстового ответа.

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

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

Результат и полезный итоговый материал

Руководство семейства документирует изображения до 4 мегапикселей, явные размеры не менее 64×64 и кратность 16. Рекомендация для обычного применения — до 2 мегапикселей. Конкретный профиль [max] перечисляет JPEG, PNG и WebP, по умолчанию JPEG, и необязательный случайный seed. Выберите форму результата под размещение до построения композиции. Генерация модели отделена от изменения размеров уже готового материала.

При выборе итоговой версии сохраняйте изображение, референсы, промпт, размеры и идентичность модели. Руководство FLUX.2 предупреждает о временной подписанной ссылке с десятиминутным окном получения. Проверяйте мелкий текст, идентичность предметов, макет, свет и сведения из поиска в целевом размере показа. Полезный материал — выбранный визуал с достаточным контекстом для точной дальнейшей правки, а не сцена, важные детали которой не сравнивали с заданием.

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

black-forest-labs/flux.2-max

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

Начало

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

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

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

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

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения black-forest-labs/flux.2-max	По умолчанию—
Поле`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.14 за мегапиксель выходного изображения
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётная единица—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.14 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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-max', '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-max

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

/v1/images

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

black-forest-labs/flux.2-max

FAQ · Black Forest Labs: FLUX.2 Max

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

Black Forest Labs: FLUX.2 Max