black-forest-labs

1# FLUX image API
2 
3## Purpose
4Generate images with the FLUX.2 family via Black Forest Labs' official API: `flux-2-pro` for general text-to-image and native image editing, `flux-2-flex` for typography and text-heavy images. The quality bar for custom imagery in the catalog. Regional hosts exist for GDPR (`api.eu.bfl.ai`) and US (`api.us.bfl.ai`).
5 
6## Tooling
7All commands go through `bin/black-forest-labs.py`:
8 
9```bash
10bin/black-forest-labs.py auth                                             # verify credential setup (no spend)
11bin/black-forest-labs.py generate --prompt "a fox in a field of wheat"    # submit; prints a polling_url
12bin/black-forest-labs.py generate --prompt "poster that says OPEN LATE" --model flux-2-flex
13bin/black-forest-labs.py generate --prompt "..." --region https://api.eu.bfl.ai
14bin/black-forest-labs.py status --polling-url 'https://api.bfl.ai/v1/get_result?id=...'   # poll until Ready
15bin/black-forest-labs.py result --polling-url 'https://api.bfl.ai/v1/get_result?id=...'  # fetch the result
16```
17 
18`generate` returns a `polling_url`. Poll `status` with backoff; when status is `Ready`, the response carries the sample download URL. `--json` merges extra fields (width, height, seed, input images for editing) into the request.
19 
20## Auth
21- Provider id: `black-forest-labs` (credential is collected as `custom.black-forest-labs`)
22- Collection: API key via the secure credential flow (`credentials.request_api_access`); created at dashboard.bfl.ai
23…