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/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 · Картинки
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}/contentGET /v1/media/assetsGET /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 для вызова
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