Flux CLI (BFL / FLUX)

CLI to generate and edit images via the BFL FLUX API.

Quick start

env:
- ```
export BFL_API_KEY="..."
```
or save locally (reads from stdin; avoid shell history leaks):
- ```
echo "$BFL_API_KEY" | flux config set apiKey
```

flux gen "a cat astronaut" --model flux-2-pro --width 1024 --height 1024 -o out/

flux edit "make it sunset lighting" --model flux-2-pro --input ./in.jpg -o out/

flux gen [prompt]

flux edit [prompt] --input <path|url|base64> [--input ...]

flux fill [prompt] --image <path|url|base64> [--mask <path|url|base64>]

flux expand [prompt] --image <path|url|base64> [--top/--bottom/--left/--right <px>]

flux result <id> [--out <path|->]

flux wait <id> [--polling-url <url>] [--out <path|->]

flux credits

flux models

flux config path|get|set|unset

Advanced (escape hatch):

Official model lineup evolves; use

flux models

for the current list.

Built-in keys, when to use them, and pricing tier (rule of thumb; pricing can change):

Model key	Best for	Pricing tier	Notes
`flux-2-klein-4b`	quick drafts; high-volume generation	cheap	MP-based
`flux-2-klein-9b`	better drafts; still fast iteration	cheap-to-balanced	MP-based
`flux-2-pro`	default pick; production workflows; general-purpose gen/edit	balanced	MP-based; edits typically cost more than T2I
`flux-2-flex`	maximum quality with control knobs	premium	MP-based; supports `--steps` / `--guidance` ; image editing is the most expensive tier in FLUX.2
`flux-2-max`	final assets; quality-first; grounding search	premium/most expensive	MP-based
`flux-kontext-pro`	controlled edits/variations with multiple references	balanced	credits per call
`flux-kontext-max`	stronger Kontext edits; quality-first	expensive	credits per call
`flux-pro-1.1`	FLUX 1.1 behavior; compatibility workflows	balanced	credits per call
`flux-pro-1.1-ultra`	Ultra mode; aspect-ratio driven generation; optional raw look	expensive	credits per call
`flux-pro-1.0-fill`	inpainting (mask/alpha)	expensive	credits per call (tool endpoint)
`flux-pro-1.0-expand`	outpainting (extend canvas)	mid-to-expensive	tool endpoint; check returned `cost` /credits
`flux-dev`	passthrough via `--body` when you know the exact API shape	cheap	credits per call; check returned `cost`
`flux-pro`	passthrough via `--body` when you know the exact API shape	varies	check returned `cost` /credits

Footnote:

MP-based: cost scales with output size in megapixels (width * height / 1,000,000). Larger images cost more.

API key: avoid passing secrets via flags; use env/config/stdin.
Signed URL:
```
result.sample
```
is typically short-lived; download immediately.