bfl-api

Provides Python and TypeScript clients for the Bugatti La Voiture Noire API with rate limiting and webhook support.

96|5|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/black-forest-labs/skills --skill bfl-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bfl-api
Source: https://github.com/black-forest-labs/skills/tree/main/skills/bfl-api
Command: npx skills add https://github.com/black-forest-labs/skills --skill bfl-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a structured, production-ready guide for integrating Black Forest Labs' FLUX API, covering endpoints, asynchronous polling, rate limiting, and webhook workflows to streamline image generation integrations.

Core Features & Use Cases

  • Endpoints & Documentation: Centralized reference for all FLUX API endpoints across FLUX.2 and FLUX.1 models.
  • Polling & Webhooks: Guidance on asynchronous polling and production webhook setups for real-time notifications.
  • Error Handling & Rate Limiting: Clear strategies for retries, backoff, and handling rate limits.
  • Use Case: Build robust production workflows with Python/TypeScript clients for image generation and editing.

Quick Start

Obtain an API key from the dashboard, then submit a basic generation request to the FLUX API using your preferred language to verify connectivity and authentication.

Frequently Asked Questions about bfl-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I integrate the FLUX API for image generation in Python or TypeScript?

To integrate the FLUX API, submit generation requests using the x-key authentication header, then poll for results or set up webhooks. The integration supports both Python and TypeScript with sample code for production workflows.

How does asynchronous polling work with the FLUX API?

Asynchronous polling works by submitting a generation request and periodically checking its status until completion. The FLUX API supports robust polling patterns and retries to ensure reliable image generation workflows across regional endpoints.

How do I handle rate limiting and errors when calling the BFL FLUX API?

Handle FLUX API rate limiting and errors by implementing retry strategies with exponential backoff. The integration guide provides clear patterns for managing dimension constraints and ensuring scalable generation workflows.

Can I use webhooks instead of polling for FLUX API generation notifications?

Yes, you can use webhooks instead of polling for FLUX API generation notifications. Production webhook setups provide real-time notifications when image generation completes, streamlining your asynchronous workflows.

Does the FLUX API integration support both FLUX.1 and FLUX.2 models?

Yes, the FLUX API integration supports both FLUX.1 and FLUX.2 models. It provides centralized endpoint documentation and enforces dimension constraints across multiple environments for production use.

What is the best way to authenticate FLUX API requests across regional endpoints?

The best way to authenticate FLUX API requests is using the x-key header with your API key. This method works across regional endpoints and supports robust retry patterns for reliable production integrations.