# FLUX.2 [pro] API (Black Forest Labs)

> FLUX.2 [pro] from Black Forest Labs generates photorealistic images up to 4 megapixels with strong prompt adherence and clean text, and edits with up to 8 reference images.

Page: https://cheapergen.com/models/bfl/flux-2-pro · API reference: https://cheapergen.com/models/bfl/flux-2-pro/api

## Pricing
Official list price source: BFL API list price for FLUX.2 [pro] ($0.03 for the first output megapixel, $0.015 per additional MP; input images $0.015 / MP). Prices verified 2026-10-16.

| Tier | Official | Cheaper Gen. | Save |
|---|---|---|---|
| 1 MP | $0.0300/image | $0.0264/image | 12% |
| 2 MP | $0.0450/image | $0.0396/image | 12% |
| 3 MP | $0.0600/image | $0.0385/image | 36% |
| 4 MP | $0.0750/image | $0.0660/image | 12% |

## Specs
- Resolutions: 1 · 2 · 3 · 4 MP
- Aspect ratios: 1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3 · 21:9 · 9:21

## Endpoints

### Text to Image — `POST https://cheapergen.com/api/v1/run/bfl/flux-2-pro/text-to-image`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| aspect_ratio | string (enum) (1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, 9:21) | no | Output image shape. |
| resolution | string (enum) (1MP, 2MP, 3MP, 4MP) | no | Output size in megapixels (1 MP ≈ 1024×1024). FLUX.2 is billed per megapixel. |
| prompt_upsampling | boolean | no | Let the model expand and rewrite the prompt before generating. |
| seed | integer | no | Use the same seed and settings to reproduce a result. Leave empty for random. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/bfl/flux-2-pro/text-to-image \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Editorial photo of a ceramic vase with dried flowers on a linen-covered table, soft north light, film grain",
  "aspect_ratio": "1:1",
  "resolution": "1MP"
}'
```

### Image Edit — `POST https://cheapergen.com/api/v1/run/bfl/flux-2-pro/edit`

| Param | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Describe the shot: subject, action, camera movement, lighting and style. |
| image_urls | string[] (URLs) | yes | Up to 8 reference images to edit or combine. Refer to them as "image 1", "image 2"… in the prompt. |
| aspect_ratio | string (enum) (auto, 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3) | no | Output image shape. |
| resolution | string (enum) (1MP, 3MP) | no | Output size in megapixels (1 MP ≈ 1024×1024). FLUX.2 is billed per megapixel. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/bfl/flux-2-pro/edit \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Place the sneaker from image 1 on the concrete plinth in image 2, matching the hard afternoon shadows",
  "image_urls": [
    "https://cdn.cheapergen.ai/samples/portrait.jpg"
  ],
  "aspect_ratio": "auto",
  "resolution": "1MP"
}'
```

## Getting the result
Jobs are async. Poll `GET https://cheapergen.com/api/v1/generations/{id}` until status is succeeded/failed/canceled, or pass `webhook_url`. Failed generations are refunded automatically.

## FAQ
**How is FLUX.2 [pro] priced?**
FLUX.2 [pro] is billed per image by output megapixels, like Black Forest Labs' own API: a price for the first megapixel and a price for each additional one. Failed generations are not charged.

**Is this the official FLUX.2 [pro]?**
Yes. Requests run on Black Forest Labs' FLUX.2 [pro] model through official API channels, at a lower price than the BFL list price.

**Can I use the output commercially?**
Yes, outputs of the FLUX API models can be used commercially, subject to Black Forest Labs' terms and our Terms of Service.

FLUX.2 [pro] is developed by Black Forest Labs. Cheaper Gen. provides API access and does not own the model.