> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bfl.ml/llms.txt
> Use this file to discover all available pages before exploring further.
# FLUX.2 Text to Image
> FLUX.2 is the recommended model for text-to-image generation. Generate high-fidelity images with advanced control, exact colors, and flexible aspect ratios.
**FLUX.2** brings enterprise-grade efficiency and professional precision to text-to-image generation. It closes the gap between generated and real imagery with accurate hands, faces, and textures—all while respecting brand guidelines through hex-code color steering. **\[max]** offers the highest quality with grounding search for real-time information.
**Try it live** — Test FLUX.2 \[max], \[pro], \[flex] and \[klein] in the [playground](https://playground.bfl.ai). \[klein] is also available on [Hugging Face](https://huggingface.co/black-forest-labs).
## Examples
### Photorealistic
### Typography & Design
FLUX.2 \[max] searches the web when prompted, so you can generate visuals grounded in real-time information — sports scores, weather, or historical events.
Specify brand colors via hex codes with precision matching — no approximation.
Use JSON-structured prompts for precise control over generation — ideal for production workflows and automation.
```json Example: Structured Prompting theme={null}
{
"subject": "Mona Lisa painting by Leonardo da Vinci",
"background": "museum gallery wall, ornate gold frame",
"lighting": "soft gallery lighting, warm spotlights",
"style": "digital art, high contrast",
"camera_angle": "eye level view",
"composition": "centered, portrait orientation"
}
```
## API Integration
### Create Request
```bash create_request.sh theme={null}
request=$(curl -X POST \
'https://api.bfl.ai/v1/flux-2-pro-preview' \
-H 'accept: application/json' \
-H "x-key: ${BFL_API_KEY}" \
-H 'Content-Type: application/json' \
-d '{
"prompt": "A serene mountain landscape at golden hour, soft diffused light filtering through clouds",
"width": 1024,
"height": 1024
}')
echo $request
request_id=$(echo $request | jq -r .id)
polling_url=$(echo $request | jq -r .polling_url)
```
```python create_request.py theme={null}
import os
import requests
response = requests.post(
'https://api.bfl.ai/v1/flux-2-pro-preview',
headers={
'accept': 'application/json',
'x-key': os.environ.get("BFL_API_KEY"),
'Content-Type': 'application/json',
},
json={
'prompt': 'A serene mountain landscape at golden hour, soft diffused light filtering through clouds',
'width': 1024,
'height': 1024,
},
).json()
request_id = response["id"]
polling_url = response["polling_url"]
```
### Poll for Result
```bash poll_result.sh theme={null}
while true; do
sleep 0.5
result=$(curl -s -X 'GET' \
"${polling_url}" \
-H 'accept: application/json' \
-H "x-key: ${BFL_API_KEY}")
status=$(echo $result | jq -r .status)
echo "Status: $status"
if [ "$status" == "Ready" ]; then
echo "Result: $(echo $result | jq -r .result.sample)"
break
elif [ "$status" == "Error" ] || [ "$status" == "Failed" ]; then
echo "Generation failed: $result"
break
fi
done
```
```python poll_result.py theme={null}
import time
import os
import requests
while True:
time.sleep(0.5)
result = requests.get(
polling_url,
headers={
'accept': 'application/json',
'x-key': os.environ.get("BFL_API_KEY"),
},
params={'id': request_id}
).json()
if result['status'] == 'Ready':
print(f"Image ready: {result['result']['sample']}")
break
elif result['status'] in ['Error', 'Failed']:
print(f"Generation failed: {result}")
break
```
Signed URLs are only valid for 10 minutes. Please retrieve your result within this timeframe.
For all available parameters, endpoints, and model options, see the [API Reference](/api-reference).