AIKraft/Skills/bfl-api

bfl-api

Интеграция с BFL FLUX API: работа с эндпоинтами, асинхронный опрос, обработка ошибок и вебхуки. Примеры кода на Python и TypeScript. Полезно при разработке с этим API.

openmontageinc official Разработка ★ 78.4k

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

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

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

  • Генерация изображений по текстовому описанию (Text-to-Image) с выбором модели и региона.
  • Редактирование изображений (Image-to-Image) с использованием одного или нескольких референсов.
  • Настройка асинхронного опроса статуса выполнения задач или конфигурация вебхуков для продакшена.
  • Обработка ошибок, управление лимитами запросов и проверка валидности API-ключа перед использованием.

Как работает

  1. Проверить наличие переменной окружения BFL_API_KEY и убедиться в аутентификации.
  2. Выбрать подходящий региональный эндпоинт (Global, EU, US) и модель FLUX.
  3. Отправить POST-запрос с промптом и параметрами (включая input_image для редактирования).
  4. Использовать polling_url для асинхронного опроса статуса до получения ответа 'Ready' или 'Error'.
  5. Немедленно скачать изображение по результату, так как URL истекает через 10 минут.

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

Сгенерируй изображение горного пейзажа на закате, используя BFL FLUX API.
Отредактируй фото, заменив фон на закат, используя BFL API с мульти-референсом.
Настрой асинхронный опрос статуса задачи генерации изображения через BFL API.

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

  • Установленная переменная окружения BFL_API_KEY
  • Доступ к интернету для обращения к эндпоинтам api.bfl.ai
  • Инструменты для выполнения HTTP-запросов (cURL, Python или TypeScript клиенты)

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

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

1Скачать навык
# возьмите папку навыка «openmontageinc-bfl-api» из репозитория: # https://github.com/openmontageinc/openmontage
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r openmontageinc-bfl-api/ ~/.claude/skills/openmontageinc-bfl-api/

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