bfl api

Что делает навык

Навык обеспечивает интеграцию с BFL FLUX API для генерации, редактирования и обработки изображений, поддерживая модели FLUX.1 и FLUX.2. Он охватывает настройку клиента, асинхронный опрос (polling), обработку ошибок, вебхуки и работу с региональными эндпоинтами.

Когда применять

• Генерация изображений по текстовому описанию (Text-to-Image) с выбором модели по качеству и скорости.
• Редактирование изображений (Image-to-Image) с использованием одной или нескольких входных картинок.
• Многоканальное редактирование (Multi-Reference I2I) для объединения элементов, переноса стиля или обеспечения консистентности персонажей.
• Построение надежных интеграций с обработкой ограничений частоты запросов (rate limits) и временных ссылок на результаты.

Как работает

1. Проверить наличие переменной окружения BFL_API_KEY и убедиться в аутентификации.
2. Отправить POST-запрос на соответствующий эндпоинт модели (например, /v1/flux-2-pro) с параметрами запроса.
3. Получить polling_url из ответа и выполнять GET-запросы до получения статуса 'Ready' или 'Error'.
4. Скачать изображение по ссылке из результата немедленно, так как URL истекает через 10 минут.
5. При необходимости настроить webhook_url для асинхронного уведомления о завершении в продакшен-среде.

Примеры запросов агенту

Что понадобится

• Установленная переменная окружения BFL_API_KEY
• Доступ к интернету для обращения к эндпоинтам api.bfl.ai, api.eu.bfl.ai или api.us.bfl.ai

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.