# BFL Flux 1 Schnell API

> Flux 1 Schnell 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/models/bfl/flux-1/schnell
API reference: https://www.sandbase.ai/models/bfl/flux-1/schnell/docs

## Facts

- Provider: BFL
- Type: Image model
- Model ID: `bfl/flux-1/schnell`
- Price: $0.003 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-1/schnell",
  "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
  "aspect_ratio": "16:9",
  "output_format": "jpeg",
  "guidance_scale": 3.5,
  "num_inference_steps": 4
}'
```

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 1 Schnell through SandBase?

Create a SandBase API key, then send requests with the model ID "bfl/flux-1/schnell" 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 1 Schnell and the other models in the catalog; you do not need to sign up with BFL separately.

## README

### Flux 1 Schnell

FLUX.1 [schnell] generates an image in 1–4 steps, the cheapest FLUX option for quick drafts.

#### Fields

| Field | Type | Default | Notes |
|---|---|---|---|
| `prompt` | string, required | — | Text instruction. |
| `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. |
| `guidance_scale` | number 1–20 | 3.5 | How strictly to follow the prompt. |
| `num_inference_steps` | integer 1–12 | 4 | More steps add detail and time. |
| `output_format` | `jpeg` / `png` | `jpeg` | Output file format. |
| `seed` | integer | random | Fix it to compare prompt changes. |

#### Billing

$0.003 per image.

| Request | Price |
|---|---|
| One image | $0.003 |

Failed runs are not charged.

#### Prompting

- Keep prompts short and concrete.

#### Limits

- One image per request.

#### Also on SandBase

Related: `bfl/flux-2/klein/4b` (newer, fast).