Обзор
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.
API преобразования текста в изображение
/v1/images/generations, создавайте изображения по текстовым prompt для всех 5 моделей FLUX.2.API редактирования изображений
input_image (до 8 референсов для fusion, через /generations), плюс совместимый с OpenAI multipart /edits путь для одного изображения. Работает для FLUX.2 + FLUX.1 Kontext.Исторические версии
Доверьте интеграцию ИИ-агенту
Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor
Сначала он загрузит текстовую версию этой страницы (добавьте .md к любому URL документации), а затем напишет код для стека вашего проекта — таймаут, 10-минутный срок действия URL, требующий немедленного копирования на стороне сервера, сжатие при загрузке и правило кратности размеров 16 уже включены в требования.
Integrate / troubleshoot FLUX text-to-image and image editing in this project.
Read the docs before you touch code: fetch https://docs.apiyi.com/en/api-capabilities/flux/overview.md for the plain-text version of this page. For finer parameter detail, append
.mdto the text-t …
- Timeout: set the client timeout to 120 seconds, or 180 seconds if you are using
flux-2-flex. The image APIs are synchronous — there is no task ID, so …
Всего 7 требований. Используйте кнопку ниже, чтобы скопировать весь prompt.
От каких проблем избавляет этот prompt
От каких проблем избавляет этот prompt
Почему стоит выбрать FLUX от APIYI?
Прямая замена официального канала BFL, оптимизированная по стабильности, стоимости и удобству интеграции для production:OpenAI-совместимая обёртка · Миграция без кода
base_url OpenAI SDK — не нужно писать собственный цикл polling_url.Без ограничения на параллельные запросы · Более 24 активных задач
flux-kontext-max — только 6). APIYI распределяет запросы на уровне шлюза, поэтому корпоративные пользователи масштабируются линейно без ограничения на один аккаунт.Та же цена или скидка до 17%
Глобальный доступ без лишних сложностей
api.apiyi.com со стабильной задержкой.Полная экосистема моделей
Профессиональный сервис · Корпоративная поддержка
Ключевые особенности
Полный спектр скоростей
Нативный вывод в разрешении 4 Мп
Объединение нескольких референсов
input_image ~ input_image_8 позволяют передавать несколько референсов (URL или base64 data URL): FLUX.2 [pro/max/flex] — до 8, [klein] — до 4. Указывайте их в prompt как «изображение 1 / изображение 2».Поиск с привязкой к актуальным данным
Точное управление цветами по HEX-коду
#02eb3c / #ff0088, прямо в prompt. Модель точно воспроизводит цвета — для работ, где важна точная передача фирменных цветов, постобработка не нужна.Длинные промпты до 32K tokens
Оптимизация типографики
Подключение через OpenAI SDK без изменений кода
base_url в значение https://api.apiyi.com/v1 и вызывайте client.images.generate(model="flux-2-pro", ...) напрямую — менять код не нужно.Примеры результатов
Текст в изображение · минималистичный снимок продукта (flux-2-klein-4b; только prompt: флакон духов из матового стекла на светло-серой поверхности, мягкий свет с одной стороны, чистый фон, пустая этикетка): 4,7 с — самый быстрый результат среди семейств моделей, стоимость одного вызова — $0.01; чёткий контровой свет по краю, правильное направление тени и никаких лишних деталей.

flux-2-klein-4b; на исходном изображении — рыжий кот на подоконнике, prompt: преобразуйте изображение в акварельную иллюстрацию, сохранив позу кота и расположение подоконника и растения): 24,9 с; мазки кисти и растекание краски хорошо заметны, при этом окрас кота, растение и оконная рама остаются на прежних местах.

Цены
Тарификация за изображение — см. столбец Цена 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.
Размер (ширина / высота) в деталях
Типовые размеры
Ограничения пользовательского размера
FLUX.2 принимает произвольные размеры, если выполняются все следующие условия:- ширина / высота должны быть кратны 16
- Минимум 64×64
- Максимум ~4MP (например, 2048×2048 / 1920×2048 / 2048×1920)
- Рекомендуемый итоговый размер ≤ 2MP, чтобы сбалансировать скорость и стоимость
1280x720, 1920x1080, 2048x1024, 1456x1920
Недопустимые примеры: 1000x1000 (не кратно 16), 3840x2160 (превышает 4MP), 32x32 (ниже 64×64)
Лучшие практики
Выбирайте модель по сценарию
flux-2-max. Пакетная обработка в production → flux-2-pro. Постеры / инфографика с типографикой → flux-2-flex. Реальное время с высокой пропускной способностью → flux-2-klein-9b. Редактирование изображений → flux-kontext-max или flux-kontext-pro.По умолчанию используйте ≤ 2MP
Указывайте референсные изображения по индексу в prompt
input_image / input_image_2 / input_image_3 — это в точности индекс «image 1 / image 2 / image 3» в вашем prompt. Скажите «человек с изображения 1 в сцене изображения 2 с цветовой палитрой изображения 3» — это гораздо надежнее, чем заставлять model угадывать.Сразу скачивайте URLs результата
data[0].url действителен только 10 минут, размещен на delivery-eu.bfl.ai / delivery-us.bfl.ai, при отключенном CORS. В production необходимо скачивать их на стороне сервера в свой CDN.Фиксируйте типографику на flex или max
flux-2-flex (специалист по типографике) или flux-2-max (наивысшее общее качество). Другие модели по-прежнему могут размывать мелкий текст.Используйте max для grounding-поиска
flux-2-max. Остальные модели опираются на данные обучения и не могут получать актуальную информацию.Тайм-аут клиента 60–120s
Фиксируйте seed для воспроизводимости
seed + одинаковые остальные параметры = стабильные результаты, полезно для A/B-тестов и проверки клиентом. klein не поддерживает prompt_upsampling; у pro/max/flex он отключен по умолчанию — включайте при необходимости.Коды ошибок и повторные попытки
- Тайм-аут запроса 60–120s (с возможностью увеличения до 180s)
- Экспоненциальная задержка повторов для 5xx и 429 (рекомендуется 2 повтора)
- Как только получен
data[0].url, сразу скачивайте асинхронно — не ждите клика пользователя - Логируйте заголовок ответа
x-request-idдля поддержки
Часто задаваемые вопросы
Почему поле url истекает через 10 минут?
Почему поле url истекает через 10 минут?
delivery-eu.bfl.ai / delivery-us.bfl.ai с подписанными URL, действительными 10 минут, и CORS отключен. Производственные сервисы должны на стороне сервера загружать их в ваш собственный OSS / CDN. Не передавайте исходный URL в браузеры и не рассчитывайте, что пользователи смогут открыть его позже.APIYI наследует тот же механизм URL — поведение совпадает с официальным каналом.Официальный API использует асинхронный опрос — как APIYI делает его синхронным?
Официальный API использует асинхронный опрос — как APIYI делает его синхронным?
polling_url до Ready, затем оборачивает итоговый URL result.sample как data[0].url и возвращает его. С точки зрения клиента это один запрос-ответ — идентично OpenAI / GPT-Image / Nano Banana.Сколько референсных изображений я могу отправить? Как писать prompt?
Сколько референсных изображений я могу отправить? Как писать prompt?
- FLUX.2 [pro/max/flex]: до 8
- FLUX.2 [klein]: до 4
- FLUX.1 Kontext [pro/max]: один референс (для нескольких изображений нужна склейка на стороне клиента)
Что делает prompt_upsampling? Стоит ли его включать?
Что делает prompt_upsampling? Стоит ли его включать?
prompt_upsampling=true автоматически расширяет и уточняет ваш prompt (особенно полезно для коротких prompt). Но это меняет исходный замысел — держите его выключенным для брендовых задач и включенным для свободного эксперимента.Ограничение: FLUX.2 [klein] это не поддерживает (если передать, будет молча проигнорировано).Как использовать grounding search?
Как использовать grounding search?
flux-2-max. Никаких специальных параметров не нужно — если вашему prompt нужны знания в реальном времени, модель автоматически выполнит поиск в сети перед генерацией. Пример:«Сгенерируйте новостное фото снежной бури, накрывшей Нью-Йорк 15 декабря 2025 года»Отлично подходит для «счета вчерашнего матча», «погоды в реальном времени», «воссоздания исторического события», «последних трендов». Prompt без чувствительного ко времени контента не запустит поиск и будет тарифицироваться как обычная генерация.
Как эффективнее всего использовать hex-цвета?
Как эффективнее всего использовать hex-цвета?
Что такое структурированный JSON prompting?
Что такое структурированный JSON prompting?
prompt. Идеально для производственной автоматизации и пакетной генерации по шаблону.Какой endpoint мне использовать для редактирования изображений?
Какой endpoint мне использовать для редактирования изображений?
- Вариант 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
Могу ли я напрямую использовать официальный SDK OpenAI?
Могу ли я напрямую использовать официальный SDK OpenAI?
base_url в https://api.apiyi.com/v1:openai. Все модели FLUX используют формат ответа OpenAI Images API с data[0].url.Могу ли я отменить выполняющуюся задачу?
Могу ли я отменить выполняющуюся задачу?
Каковы лимиты запросов и ограничения на параллельные запросы?
Каковы лимиты запросов и ограничения на параллельные запросы?
flux-kontext-max отдельно ограничивает до 6.APIYI агрегирует нагрузку на шлюзе, поэтому корпоративные параллельные запросы не ограничены потолком на уровне аккаунта. Для явных обязательств по SLA / RPM свяжитесь с нашей командой, чтобы получить выделенную квоту.Работают ли callback через webhook?
Работают ли callback через webhook?
webhook_url + webhook_secret, но обертка APIYI, совместимая с OpenAI, ожидает синхронно и не передает поля webhook — вам не нужно опрашивать систему, цикл запрос-ответ выполняется за один раз. Если вашему бизнесу действительно нужны webhook, свяжитесь с нами, чтобы включить нативный асинхронный канал.Тарифицируются ли неудачные запросы?
Тарифицируются ли неудачные запросы?
400 (ошибка параметра), 403 (блокировка модерацией), 429 (превышен лимит запросов) все возвращают ошибки и не тарифицируются. Тарифицируются только запросы, которые фактически вошли в генерацию (200 + data[0].url).Похожие документы
- Песочница Text-to-Image — интерактивный отладчик
/v1/images/generations - Песочница редактирования изображений — слияние нескольких референсов + редактирование
- Исторические версии и миграция — FLUX.1 [pro] / [pro] 1.1 / Ultra / [dev]
- Руководство по API — общая спецификация использования
- Обзор GPT-Image-2 — флагман OpenAI, поддерживает 4K
- Обзор Seedream — партнерский канал BytePlus