# BFL Flux 2 Flash Text to Image API

> Flux 2 Flash by BFL - generate stunning images from text prompts with state-of-the-art AI. Supports multiple aspect ratios, styles, and high-resolution output for creative and commercial use.

Source: https://www.sandbase.ai/model/bfl/flux-2/flash
API reference: https://www.sandbase.ai/model/bfl/flux-2/flash/docs

## Facts

- Provider: BFL
- Type: Image model
- Model ID: `bfl/flux-2/flash`
- Price: From $0.03 per run
- Capabilities: text to image
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

- Unified Run API: `POST https://api.sandbase.ai/v1/run`

```bash
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "bfl/flux-2/flash",
  "prompt": "An army of ants battles for a sugar cube in a giant sandbox, with tiny plastic soldier toys caught in the melee. Ant bodies shine against gritty beige sand and the glossy, crystalline cube. Fiery sunrise spills golden highlights, throwing dramatic shadows, amplifying the excitement. Shot macro (100mm), aperture f/2.8 for soft background, centered composition with ground-level POV, mixing organic and manufactured textures.",
  "aspect_ratio": "16:9",
  "output_format": "png",
  "guidance_scale": 2.5
}'
```

The response returns a run id; poll `GET https://api.sandbase.ai/v1/run/{id}` until the status is `completed` or `failed`.

## FAQ

### How do I call BFL Flux 2 Flash Text to Image through SandBase?

Create a SandBase API key, then send requests with the model ID "bfl/flux-2/flash" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

### Do I need a separate BFL account?

No. One SandBase API key and balance gives you access to BFL Flux 2 Flash Text to Image and the other models in the catalog; you do not need to sign up with BFL separately.

## README

### Flux 2 Flash Text to Image

FLUX.2 Flash, the fastest, lowest-cost FLUX.2 variant. Text to image.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Text instruction. |
| `guidance_scale` | number 0–20 | 2.5 | How strictly to follow the prompt. |
| `output_format` | `jpeg` / `png` | `png` | Output file format. |
| `aspect_ratio` | `21:9` / `16:9` / `3:2` / `4:3` / `5:4` / `1:1` / `4:5` / `3:4` / `2:3` / `9:16` | `16:9` | Output shape. |
| `seed` | integer | random | Fix it to compare prompt changes. |

#### Billing

$0.025 per image.

| Request | Price |
|---|---|
| One image | $0.025 |

Failed runs are not charged.

#### Prompting

- Write subject, setting, composition, style, then light.
- Quote any text that must appear.

#### Limits

- One output image per request.

#### Also on SandBase

Other FLUX.2 endpoints: `bfl/flux-2/max`, `bfl/flux-2/pro`, `bfl/flux-2/flex`, `bfl/flux-2/dev`, `bfl/flux-2/flash/edit`.
