Bfl Api

What it does

This skill provides guidance and assistance for integrating Black Forest Labs (BFL) FLUX APIs into applications that generate, edit, or process images. It offers information on API endpoints, pricing models, and best practices for building production-ready integrations with BFL's image generation services. The skill helps users set up their API client, handle rate limits, and configure webhooks.

When to use it

• Setting up a BFL API client within an application.
• Implementing asynchronous polling patterns when interacting with the APIs.
• Managing rate limits and handling potential errors during API calls.
• Configuring webhooks for production environments.
• Choosing appropriate regional endpoints (Global, EU, US) based on requirements like GDPR compliance or data residency.

Key capabilities

• Provides information on BFL API base endpoints for different regions (Global, EU, US).
• Details pricing models and costs associated with various FLUX.2 and FLUX.1 models.
• Outlines model paths for image generation and editing tasks.
• Offers guidance on handling temporary image URLs that expire after 10 minutes.
• Explains how to use the input_image parameter for image editing within FLUX.2 models.

Example prompts

• "What are the available regional endpoints for the BFL API?"
• "How much will it cost to generate an image using the FLUX.2 [pro] model at a resolution of 1000x1000 pixels?"
• “Show me an example curl command for editing an image with the FLUX.2 pro model.”

Tips & gotchas

• API Key: Ensure your BFL_API_KEY environment variable is set before using the API, as authentication errors will occur otherwise.
• Image URL Expiration: Downloaded images from the BFL API are only available for a short time (10 minutes). Download them immediately after generation and avoid caching the URLs themselves.
• Pricing: Use the bfl.ai/pricing calculator to accurately determine costs based on image resolution.