Quick Start - Black Forest Labs

Most modern MCP clients can connect to https://mcp.bfl.ai directly and handle the OAuth flow on their own — pick your client from the tabs below.For stdio-only or OAuth-incompatible clients (for example Hermes), use the mcp-remote fallback tab. It runs locally, handles the browser OAuth flow, refreshes tokens for you, and exposes FLUX as a normal stdio server.

See our full pricing page for complete details or use the pricing calculator.

Start generating AI images with FLUX in three steps: create an account, add credits, and make your first API call.

Create your account

Go to dashboard.bfl.ai and register your account. You’ll need to confirm your email before logging in.

When you create your account, we automatically set up:

A Default Organization - your workspace for managing team members and billing
A Default Project - where your API keys and usage are tracked

Organizations group your team and billing. Projects isolate your work with separate API keys and usage tracking. Think of organizations as your company and projects as different apps or environments.

Add credits to your account

Credits power all API and Playground usage.

Simple pricing: 1 credit = $0.01 USD

To add credits:

Go to dashboard.bfl.ai
In your organization sidebar, navigate to API → Credits
Click Add Credits
Choose your amount and complete payment via Stripe

Credits are available immediately after payment. Start with $10-20 to experiment with different models.

Full credits & billing guide

Create your API key

Prefer an interactive experience? Use our Dashboard Quickstart to create your API key and make your first call.

Navigate to API → Keys in your project sidebar and click Add Key.

Give your API key a descriptive name that helps you identify its purpose later, like “Production App” or “Testing Environment”. Each API key is scoped to its project.

Copy your API key

Your new API key will be displayed. Copy it now - for security reasons, you won’t be able to see the full key again.

Your API key is only shown once when created. Make sure to copy and store it securely before closing the dialog.

Set up your environment

Add your API key to your environment variables:

export BFL_API_KEY="your_api_key_here"

Or store it securely in your application’s configuration.

Keep your API key secure and never expose it in client-side code. Treat it like a password!

Make your first API call

Generate your first image with FLUX.2. See the image generation guide for complete code examples in Python, TypeScript, and cURL.

Want to skip the code? Try our Playground to generate images directly in your browser.

See our full pricing page for complete details or use the pricing calculator.

Next Steps

Generate Your First Image

Learn how to create images using our API

Try the Playground

Test models instantly without writing code

Explore FLUX.2

Our latest and most powerful model family

Prompting Guide

Get better results with effective prompts

​Next Steps

Generate Your First Image

Try the Playground

Explore FLUX.2

Prompting Guide

Next Steps