API-ключ BFL (Black Forest Labs)

BFL (Black Forest Labs) — провайдер моделей FLUX для генерации и редактирования изображений; именно через него Style Rewriter работает в режиме «📷 Изображение» (FLUX.1 Kontext, FLUX 1.1 Pro, FLUX.2 и другие). Это пошаговая инструкция: от создания аккаунта до вставки ключа в админку Style Rewriter.

Весь процесс занимает 5–10 минут. Интерфейс dashboard.bfl.ai на английском — все литеральные надписи в инструкции даны в таком виде.

Регистрация

BFL заводит аккаунт в развёрнутом дашборде. Поддерживается вход через Google и GitHub OAuth — это самый быстрый путь.

1. Откройте https://dashboard.bfl.ai/.
2. Нажмите Sign in (или Sign up) и выберите способ: Google, GitHub или email + пароль. Для Style Rewriter разницы нет — выбирайте тот, к которому уже привыкли.
3. Если регистрируетесь по email — подтвердите адрес по ссылке из письма.
4. На первом экране дашборда BFL может предложить заполнить профиль (компания / use-case) — поля необязательные, можно пропустить.

Российские IP-адреса BFL прямо не блокирует, но Cloudflare иногда показывает страницу проверки (CAPTCHA / interstitial). Если регистрация залипает на «Just a moment...» — подключите VPN с европейским/американским exit-узлом и повторите. После регистрации VPN не обязателен для работы API.

Биллинг и оплата

BFL работает по предоплате — нужно положить кредиты на баланс до того как ключ начнёт делать реальные генерации. Цена списывается за каждую сгенерированную картинку (per-image), модели разной цены (от $0.014 за картинку у самой дешёвой FLUX.2 [klein] до $0.05–0.08 у топовых FLUX.1 Kontext Max и FLUX 1.1 Pro).

1. В дашборде откройте раздел Billing (левая панель навигации).
2. Нажмите Add credits (или похожую кнопку — формулировка может меняться).
3. Выберите сумму пополнения. Минимум обычно $5–10. Для пробных картинок этого хватит на сотни генераций; для регулярного потока редактирования рекомендуем сразу класть $20–50.
4. Привяжите карту. BFL принимает международные Visa / MasterCard.

Российские карты (Visa/MasterCard, выпущенные в РФ) BFL не принимает. Нужна иностранная карта (Казахстан / Армения / Грузия / ЕС / США) либо виртуальная карта вроде Wise. Это блокировка по BIN-коду карты — не обходится через VPN.

Текущие цены по моделям и режимам — на странице pricing документации BFL. Списания идут на каждый 200 OK ответ от API, ошибки не тарифицируются.

Создание API-ключа

Ключ создаётся одной кнопкой и (как и у других провайдеров) показывается ровно один раз.

1. В дашборде откройте раздел API Keys (левая панель навигации).
2. Нажмите Create API Key (или + New key).
3. Введите название (Name) — оно видно только вам, нужно чтобы отличать ключи в списке. Подойдёт что-то вроде style-rewriter-prod.
4. Нажмите Create.
5. Скопируйте показанный ключ.

Про формат ключа. Placeholder в админке Style Rewriter показывает bfl-... как подсказку, но реальный формат ключа BFL — это длинная строка (обычно UUID-подобная, например a1b2c3d4-e5f6-7890-abcd-ef1234567890) без видимого префикса bfl-. Это нормально — placeholder это просто визуальная подсказка «здесь ключ от BFL», не валидатор. Вставляйте ключ как есть, в том виде, в котором его показал дашборд.

Ключ показывается ровно один раз. После закрытия модалки полная строка больше нигде в дашборде не отображается — только последние 4 символа. Скопируйте сразу и вставьте в Style Rewriter (следующий шаг). Если потеряли — удалите ключ в списке и создайте новый.

Вставка в Style Rewriter

1. В Style Rewriter войдите как админ.
2. Откройте вкладку ⚙️ Настройки в шапке.
3. Внутри настроек выберите подвкладку 🔑 API-ключи.
4. Найдите карточку BFL (Black Forest Labs).
5. Вставьте скопированный ключ в поле ввода.
6. Нажмите Сохранить.
7. Нажмите Тест ключа — кнопка отправит на бэк маленький probe-запрос к BFL и проверит, что ключ работает. Probe не генерирует картинку, поэтому деньги не тратятся.
8. Дождитесь зелёного бейджа «✓ Активен» рядом с карточкой. Если бейдж красный — см. следующий раздел.

После активации ключа модели FLUX появятся в селекторе моделей в режиме «📷 Изображение» на основном экране.

Что делать если ключ не работает

Ниже типичные ошибки от BFL и что они значат. Полный список — в документации BFL API.

• HTTP 401 Unauthorized — ключ невалидный, удалён или вставлен с пробелами. BFL аутентифицирует через заголовок x-key: <your-key>, поэтому если ключ обрезан/искажён — приходит сразу 401. Проверьте, что вставили полную строку без пробелов в начале/конце; при сомнении — удалите ключ в дашборде и создайте новый.
• HTTP 402 / insufficient balance — на балансе закончились деньги. Зайдите в Billing, проверьте остаток, при нуле — пополните. После пополнения новые запросы уйдут сразу, без задержки.
• HTTP 403 Forbidden — у ключа нет доступа к запрошенной модели. Бывает редко — обычно у BFL все модели доступны на одном ключе сразу. Если возникает — напишите в их саппорт.
• HTTP 429 Too Many Requests — превышен rate limit (лимит запросов в минуту). У свежих аккаунтов лимиты ниже, после первых тратеных $5–10 BFL обычно автоматически их поднимает. Подождите минуту и повторите.
• HTTP 400 Bad Request — запрос невалидный (обычно проблема с параметрами генерации, а не с ключом). Если возникает на «Тест ключа» — это баг Style Rewriter, напишите в поддержку.

Если Style Rewriter возвращает ошибку с непонятным текстом — откройте DevTools браузера (F12) → вкладка Network → найдите запрос на /api/keys/bfl/test → посмотрите Response. Там будет точный код ошибки от BFL с телом ответа, который проще нагуглить.