Quick Start

Start generating images with FLUX: create an account, add credits, create an API key, and make your first call — for FLUX 3 or FLUX.2.

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 it a descriptive name like “Production App” or “Testing Environment” — each key is scoped to its project. The key is shown once, so copy it right away, then add it to your environment:

export BFL_API_KEY="your_api_key_here"

Your API key is only shown once when created. Store it securely before closing the dialog and never expose it in client-side code — treat it like a password.

Make your first call

Generation is asynchronous: you POST a request, get back a polling_url, then poll it for the finished result. Here is that first request — a FLUX 3 video from a text prompt.

import os, requests

r = requests.post(
    "https://api.bfl.ai/v1/flux-3-video",
    headers={"x-key": os.environ["BFL_API_KEY"], "Content-Type": "application/json"},
    json={
        "mode": "t2v",
        "prompt": "a fox running through dawn mist",
    },
).json()
print(r["polling_url"])

curl -X POST https://api.bfl.ai/v1/flux-3-video \
  -H "x-key: $BFL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "t2v",
    "prompt": "a fox running through dawn mist"
  }'

See the image generation guide for the polling loop and full 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.

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.

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

Get Started

Account Management

FLUX 3

FLUX.2

FLUX Tools

API Integration

Training

Legacy Models

Next Steps

Generate Your First Image

Try the Playground

Explore FLUX.2

Prompting Guide

​Next Steps

Generate Your First Image

Try the Playground

Explore FLUX.2

Prompting Guide

Next Steps