models

Black Forest Labs: FLUX.2 Klein 4B

Markdown · JSON

Black Forest Labs: FLUX.2 Klein 4B

FLUX.2 [klein] 4B — компактная модель изображений Black Forest Labs с дистилляцией шагов для создания по тексту и редактирования с набором до четырёх референсов. Четырёхшаговая схема поддерживает интерактивную визуальную работу и отличается от недистиллированной версии Base 4B.

О модели

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

FLUX.2 [klein] 4B — компактная модель Black Forest Labs для создания изображения по тексту и редактирования с визуальными референсами. Её трансформер rectified flow с четырьмя миллиардами параметров объединяет генерацию и редактирование в одной архитектуре. Версия с названием 4B дистиллирована по шагам, а эталонный пример разработчика использует четыре шага вывода.

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

Редактирование с небольшим набором референсов

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

Разработчик отличает этот компактный референсный бюджет от более крупных вариантов FLUX.2. Также указано, что [klein] не расширяет промпт. Самостоятельно предоставьте важные описательные сведения, включая отношения между объектами референсов, не рассчитывая на автоматическое расширение краткой метки. Для серии сохраняйте тот же референс объекта и визуальные требования, меняя по одному решению сцены.

Настройки результата и границы версий

Точный профиль 4B разработчика перечисляет JPEG, PNG и WebP, по умолчанию JPEG. Документированы явные ширина и высота, каждая не менее 64 пикселей; пример карточки модели использует изображение 1024×1024. Этот пример — конфигурация сэмплирования, а не утверждение, что все задачи должны быть квадратными или что 1024 пикселя — максимум модели. Выберите кадрирование и форму показа до составления задания, затем сравните мелкие надписи и детали в этом размере.

Опубликованный четырёхшаговый пример использует guidance_scale 1.0. Различайте эту дистиллированную версию и FLUX.2 [klein] Base 4B, чей недистиллированный обучающий сигнал предназначен для адаптации, обучения LoRA и исследований. Base 4B и модели 9B — отдельные варианты с иными особенностями подготовки и сэмплирования. Стандартные настройки компактной модели также отличаются от регулируемых шагов и guidance модели [flex]; [max] имеет собственный поиск для привязки к источникам.

Что проверить на изображении

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

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

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

black-forest-labs/flux.2-klein-4b

Black Forest Labs /black-forest-labs/flux.2-klein-4b

Начало

FLUX.2 [klein] 4B — компактная модель изображений Black Forest Labs с дистилляцией шагов для создания по тексту и редактирования с набором до четырёх референсов. Четырёхшаговая схема поддерживает интерактивную визуальную работу и отличается от недистиллированной версии Base 4B.

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

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

Ailoot Ultra · Картинки POST /v1/images/generations
Входные данные
text, image
Результат
image
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
black-forest-labs/flux.2-klein-4b
По умолчанию—
Поле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
Максимум элементов: 4
По умолчанию—
Поле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.028 за мегапиксель выходного изображения
КонфигурацияОриентировочная стоимость генерацииШкала ставок—Прогноз количестваОценка для одной генерацииРасчётная единица—Плата
Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.028 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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-klein-4b', '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-klein-4b

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

/v1/images

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

black-forest-labs/flux.2-klein-4b

FAQ · Black Forest Labs: FLUX.2 Klein 4B
Какие входные данные и результаты доступны?

POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: text, image → image

Какие поля использует запрос?

POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: model, prompt, aspect_ratio, output_format, n, input_references, provider

Какие ограничения действуют?

POST /v1/images/generations · black-forest-labs/flux.2-klein-4b: n.minimum: 1; n.maximum: 1

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

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

Запросить реселлерскую лицензию · Оферта и лицензионный договор