Skip to main content

​
Обзор

FLUX — флагманская семейство моделей генерации изображений от Black Forest Labs (BFL), базирующейся в Германии. Последнее поколение FLUX.2 охватывает 5 уровней — от качества за доли секунды до флагманского качества 4MP — а также предыдущее поколение FLUX.1 Kontext для редактирования изображений, всего 7 активных моделей. Наследуемые модели FLUX.1 [pro] также по-прежнему доступны для вызова. Шлюз APIYI оборачивает асинхронный polling API BFL в синхронный OpenAI Images API (/v1/images/generations и /v1/images/edits), так что вы можете подключить OpenAI SDK, изменив лишь base_url.
🎨 Основные преимущества: FLUX.2 [max] уникально поддерживает grounding search для получения знаний из веба в реальном времени. Нативный вывод 4MP (2048×2048) + до 8 изображений-референсов + промпты до 32K token + точное управление hex-цветами + лучшая в классе типографика. Идеально подходит для флагманского качества, согласованности между несколькими изображениями, точной передачи фирменных цветов и профессиональных макетов в продакшене.
Все image API являются синхронными — здесь нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Установите для этой модели щедрый timeout; см. Основы и лучшие практики Image API.

API преобразования текста в изображение

/v1/images/generations, генерируйте изображения из текстовых prompt во всех 5 моделях FLUX.2.

API редактирования изображений

Поля JSON input_image (до 8 reference для fusion через /generations), а также совместимый с OpenAI multipart /edits путь для одного изображения. Работает для FLUX.2 + FLUX.1 Kontext.

Исторические версии

Спецификации, примечания по миграции и тарификация для FLUX.1 [pro] / [pro] 1.1 / [pro] 1.1 Ultra / [dev].

​
Почему стоит выбрать FLUX от APIYI?

Прямая замена официального канала BFL, оптимизированная по стабильности, стоимости и удобству интеграции для production:

OpenAI-совместимая обёртка · Миграция без кода

Нативный BFL использует асинхронный опрос, а APIYI оборачивает его в синхронный OpenAI Images API. Укажите здесь base_url OpenAI SDK — не нужно писать собственный цикл polling_url.

Без ограничения на параллельные запросы · Более 24 активных задач

BFL ограничивает каждый аккаунт 24 активными задачами (flux-kontext-max — только 6). APIYI распределяет запросы на уровне шлюза, поэтому корпоративные пользователи масштабируются линейно без ограничения на один аккаунт.

Та же цена или скидка до 17%

FLUX.2 [pro/max/flex] соответствуют официальной цене при 1MP, klein 4B/9B примерно на 28% дешевле, FLUX.1 [pro] 1.1 Ultra экономит 17%, а суммирование бонусов за пополнение дает до 15% дополнительной скидки.

Глобальный доступ без лишних сложностей

Не требуется зарубежный сервер или proxy. Дата-центры материкового Китая, домашние сети и глобальные узлы могут напрямую обращаться к api.apiyi.com со стабильной задержкой.

Полная экосистема моделей

Сочетайте с gpt-image-2, Seedream, Nano Banana и другими на одном и том же шлюзе — комбинируйте под каждый сценарий.

Профессиональный сервис · Корпоративная поддержка

Наша команда обладает глубоким опытом внедрения генерации изображений — от выбора моделей и настройки до поддержки интеграции от PoC до production.

​
Ключевые возможности

Полный спектр скорости

klein 4B/9B меньше секунды на потребительских GPU, pro < 10s, max < 15s, flex медленнее для более высокой точности. Одна линейка — от работы в реальном времени до флагманского уровня.

Нативный вывод 4MP

До 2048×2048 (~4MP), в 2.5 раза больше, чем предел 1.6MP у FLUX.1. Любое соотношение сторон (размеры должны быть кратны 16), минимум 64×64.

Слияние нескольких референсов

Поля JSON input_image ~ input_image_8 содержат несколько референсов (URL или base64 data URL): FLUX.2 [pro/max/flex] — до 8, [klein] — до 4. Ссылайтесь на них в prompt как «image 1 / image 2».

Поисковая привязка

Доступно только в FLUX.2 [max]: prompts могут запускать поиск в web в реальном времени, чтобы воспроизводить «счет вчерашнего матча», «погода в реальном времени», «воссоздание исторического события» и многое другое.

Точный контроль hex-цветов

Пишите hex-коды вроде #02eb3c / #ff0088 напрямую в prompt. Модель воспроизводит точные цвета — постобработка не нужна для задач, критичных к бренду.

Длинные промпты на 32K token

Поддерживает до 32K tokens, включая структурированные описания JSON (subject / background / lighting / style). Идеально подходит для автоматизации в production.

Оптимизировано для типографики

FLUX.2 [flex] создан специально для типографики. Заголовки постеров, макеты UI, инфографика — точность мелкого текста лидирует в индустрии. max / pro тоже хорошо справляются.

OpenAI SDK Drop-in

Установите base_url в https://api.apiyi.com/v1 и вызывайте client.images.generate(model="flux-2-pro", ...) напрямую — без изменений кода.

​
Цены

Тарификация за изображение — см. столбец Цена APIYI. Официальная тарификация BFL указана за MP (megapixel), с базовой ценой в пределах 1 MP и дополнительной стоимостью за каждый следующий MP. Фиксированная тарификация APIYI за изображение более предсказуема.

​
Серия FLUX.2 (последнее поколение)

​
Серия FLUX.1 Kontext (специалист по редактированию изображений)

​
FLUX.1 [pro] Устаревшая версия (историческая, по-прежнему доступна для вызова)

Подробные спецификации и рекомендации по миграции см. на странице Исторические версии.
Примечания к тарификации:
  • APIYI использует фиксированную тарификацию за изображение — стоимость одинакова независимо от MP результата
  • Официальные цены зависят от MP: базовая цена за первый MP плюс дополнительная стоимость за каждый следующий MP
  • Запросы на редактирование стоят столько же, сколько text-to-image (в отличие от OpenAI gpt-image-2, где редактирование тарифицируется через Vision tokens)
  • Открытые веса klein 4B / klein 9B доступны на Hugging Face для self-hosting (Apache 2.0 / FLUX NCL)
  • Неудачные запросы (4xx / moderation blocks) не тарифицируются

​
Технические характеристики

​
Эндпоинты API

Для слияния нескольких референсов используйте /generations (JSON input_image_N). Эндпоинт /edits принимает только один файл image — лучше всего подходит для переноса существующего кода редактирования OpenAI SDK.
Варианты домена: api.apiyi.com — основной домен. Альтернативные домены шлюза, такие как b.apiyi.com / vip.apiyi.com, работают идентично.

​
Размер (ширина / высота) в деталях

​
Типовые размеры

​
Ограничения пользовательского размера

FLUX.2 принимает произвольные размеры, если выполняются все следующие условия:
  1. ширина / высота должны быть кратны 16
  2. Минимум 64×64
  3. Максимум ~4MP (например, 2048×2048 / 1920×2048 / 2048×1920)
  4. Рекомендуемый итоговый размер ≤ 2MP, чтобы сбалансировать скорость и стоимость
Допустимые примеры: 1280x720, 1920x1080, 2048x1024, 1456x1920 Недопустимые примеры: 1000x1000 (не кратно 16), 3840x2160 (превышает 4MP), 32x32 (ниже 64×64)
API: width/height vs OpenAI-compatible size: BFL нативно использует целые width / height. APIYI также принимает строку size: "1024x1024" в стиле OpenAI. Оба варианта эквивалентны — выберите любой.

​
Лучшие практики

1

Выбирайте модель по сценарию

Флагманская финальная версия + нужна информация в реальном времени → flux-2-max. Пакетная обработка в production → flux-2-pro. Постеры / инфографика с типографикой → flux-2-flex. Реальное время с высокой пропускной способностью → flux-2-klein-9b. Редактирование изображений → flux-kontext-max или flux-kontext-pro.
2

По умолчанию используйте ≤ 2MP

Оптимальный баланс скорости и стоимости — 1MP–2MP. К 4MP стоит прибегать только при реальной необходимости (печать, экраны 4K). При высоком разрешении klein заметно увеличивает стоимость каждого вызова.
3

Указывайте референсные изображения по индексу в prompt

Нумерация input_image / input_image_2 / input_image_3 — это в точности индекс «image 1 / image 2 / image 3» в вашем prompt. Скажите «человек с изображения 1 в сцене изображения 2 с цветовой палитрой изображения 3» — это гораздо надежнее, чем заставлять model угадывать.
4

Сразу скачивайте URLs результата

data[0].url действителен только 10 минут, размещен на delivery-eu.bfl.ai / delivery-us.bfl.ai, при отключенном CORS. В production необходимо скачивать их на стороне сервера в свой CDN.
5

Фиксируйте типографику на flex или max

Подписи, постеры, скриншоты UI — отдавайте предпочтение flux-2-flex (специалист по типографике) или flux-2-max (наивысшее общее качество). Другие модели по-прежнему могут размывать мелкий текст.
6

Используйте max для grounding-поиска

Знания в реальном времени («погода сегодня», «матч прошлой ночи») поддерживаются только на flux-2-max. Остальные модели опираются на данные обучения и не могут получать актуальную информацию.
7

Тайм-аут клиента 60–120s

APIYI обрабатывает polling внутри, а pro / max возвращают результат менее чем за 15 s, но с учетом очередей и сетевого jitter установите тайм-аут клиента на 60–120 s. flex может доходить до 180 s.
8

Фиксируйте seed для воспроизводимости

Один и тот же seed + одинаковые остальные параметры = стабильные результаты, полезно для A/B-тестов и проверки клиентом. klein не поддерживает prompt_upsampling; у pro/max/flex он отключен по умолчанию — включайте при необходимости.

​
Коды ошибок и повторные попытки

Рекомендуемая конфигурация клиента:
  • Тайм-аут запроса 60–120s (с возможностью увеличения до 180s)
  • Экспоненциальная задержка повторов для 5xx и 429 (рекомендуется 2 повтора)
  • Как только получен data[0].url, сразу скачивайте асинхронно — не ждите клика пользователя
  • Логируйте заголовок ответа x-request-id для поддержки

​
Часто задаваемые вопросы

BFL хранит результаты на delivery-eu.bfl.ai / delivery-us.bfl.ai с подписанными URL, действительными 10 минут, и CORS отключен. Производственные сервисы должны на стороне сервера загружать их в ваш собственный OSS / CDN. Не передавайте исходный URL в браузеры и не рассчитывайте, что пользователи смогут открыть его позже.APIYI наследует тот же механизм URL — поведение совпадает с официальным каналом.
Шлюз APIYI берет опрос на себя: вы отправляете стандартный запрос OpenAI Images API, шлюз внутри отправляет POST в BFL, опрашивает polling_url до Ready, затем оборачивает итоговый URL result.sample как data[0].url и возвращает его. С точки зрения клиента это один запрос-ответ — идентично OpenAI / GPT-Image / Nano Banana.
  • FLUX.2 [pro/max/flex]: до 8
  • FLUX.2 [klein]: до 4
  • FLUX.1 Kontext [pro/max]: один референс (для нескольких изображений нужна склейка на стороне клиента)
Ссылайтесь на них по индексу («изображение 1 / изображение 2 / изображение 3») в prompt, например: «поместите человека из изображения 1 в сцену из изображения 2, применив цветовую палитру изображения 3». Также работают ссылки на естественном языке — модель хорошо понимает входные изображения.
prompt_upsampling=true автоматически расширяет и уточняет ваш prompt (особенно полезно для коротких prompt). Но это меняет исходный замысел — держите его выключенным для брендовых задач и включенным для свободного эксперимента.Ограничение: FLUX.2 [klein] это не поддерживает (если передать, будет молча проигнорировано).
Это поддерживает только flux-2-max. Никаких специальных параметров не нужно — если вашему prompt нужны знания в реальном времени, модель автоматически выполнит поиск в сети перед генерацией. Пример:
«Сгенерируйте новостное фото снежной бури, накрывшей Нью-Йорк 15 декабря 2025 года»
Отлично подходит для «счета вчерашнего матча», «погоды в реальном времени», «воссоздания исторического события», «последних трендов». Prompt без чувствительного ко времени контента не запустит поиск и будет тарифицироваться как обычная генерация.
Пишите hex-коды напрямую в prompt с явными маркерами «color» или «hex»:
Или для брендовых задач с несколькими цветами:
Точность на уровне лидеров отрасли — постобработка и коррекция цвета не нужны.
FLUX.2 поддерживает prompt в формате JSON:
Передавайте JSON-строку в поле prompt. Идеально для производственной автоматизации и пакетной генерации по шаблону.
Два варианта:
  • Вариант A (рекомендуется): JSON + input_image (~ input_image_8) в /v1/images/generations — работает для всех моделей FLUX и поддерживает слияние нескольких референсов
  • Вариант B: multipart/form-data в /v1/images/edits — имя поля файла должно быть image (одно изображение), напрямую совместимо с client.images.edit() OpenAI SDK, проверено на серии Kontext
См. API редактирования изображений для параметров и примеров.Примечание: FLUX.1 Kontext нативно поддерживает только один референс; FLUX.2 поддерживает до 8 референсов (через Вариант A).
Да, без изменения кода. Установите base_url в https://api.apiyi.com/v1:
То же самое для пакета Node.js openai. Все модели FLUX используют формат ответа OpenAI Images API с data[0].url.
Не поддерживается. Если клиент отключится, сервер все равно завершит генерацию и тарифицирует ее как обычно. Задавайте таймауты на стороне клиента и не полагайтесь на «отключение = нет тарификации».
BFL ограничивает каждый аккаунт 24 активными задачами, а flux-kontext-max отдельно ограничивает до 6.APIYI агрегирует нагрузку на шлюзе, поэтому корпоративные параллельные запросы не ограничены потолком на уровне аккаунта. Для явных обязательств по SLA / RPM свяжитесь с нашей командой, чтобы получить выделенную квоту.
BFL нативно поддерживает webhook_url + webhook_secret, но обертка APIYI, совместимая с OpenAI, ожидает синхронно и не передает поля webhook — вам не нужно опрашивать систему, цикл запрос-ответ выполняется за один раз. Если вашему бизнесу действительно нужны webhook, свяжитесь с нами, чтобы включить нативный асинхронный канал.
Нет. 400 (ошибка параметра), 403 (блокировка модерацией), 429 (превышен лимит запросов) все возвращают ошибки и не тарифицируются. Тарифицируются только запросы, которые фактически вошли в генерацию (200 + data[0].url).

​
Похожие документы

FLUX — это собственная семейство моделей BFL, которое лидирует в отрасли по точности hex color, fidelity typography и пониманию длинных prompt. Если для вас важна совместимость с экосистемой OpenAI, см. GPT-Image-2; для сценариев на китайском языке см. Seedream.