# FLUX 3 API (Black Forest Labs)

> FLUX 3 from Black Forest Labs generates and edits images up to 4K with web-grounded knowledge, layout control and up to 10 reference images, at a flat price per resolution tier.

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

## Pricing
Official list price source: BFL API list price for FLUX 3 Image ($0.048 at 1K, $0.07 at 1.5K, $0.10 at 2K, $0.607 at 4K; reference images free). Prices verified 2026-10-16.

| Tier | Official | Cheaper Gen. | Save |
|---|---|---|---|
| 1K | $0.0480/image | $0.0423/image | 12% |
| 1.5K | $0.0700/image | $0.0616/image | 12% |
| 2K | $0.1000/image | $0.0880/image | 12% |
| 4K | $0.6070/image | $0.5342/image | 12% |

## Specs
- Resolutions: 1K · 1.5K · 2K · 4K
- Aspect ratios: 1:1 · 4:5 · 3:4 · 2:3 · 9:16 · 1:2 · 9:21 · 5:4 · 4:3 · 3:2 · 16:9 · 2:1 · 21:9 · 7:5 · 5:7
- Edit inputs: Up to 10 images (free)

## Endpoints

### Text to Image — `POST https://cheapergen.com/api/v1/run/bfl/flux-3/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:5, 3:4, 2:3, 9:16, 1:2, 9:21, 5:4, 4:3, 3:2, 16:9, 2:1, 21:9, 7:5, 5:7) | no | Output image shape. |
| resolution | string (enum) (1K, 1.5K, 2K, 4K) | no | Output size tier: 1K ≈ 1 MP, 1.5K ≈ 2.25 MP, 2K ≈ 4 MP, 4K ≈ 16 MP. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/bfl/flux-3/text-to-image \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "A rain-soaked night market in Taipei, steam rising from food stalls, neon signs in Chinese, 35mm photo",
  "aspect_ratio": "1:1",
  "resolution": "1K"
}'
```

### Image Edit — `POST https://cheapergen.com/api/v1/run/bfl/flux-3/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 10 reference images to edit or combine. Refer to them as "image 1", "image 2"… in the prompt. |
| aspect_ratio | string (enum) (1:1, 4:5, 3:4, 2:3, 9:16, 1:2, 9:21, 5:4, 4:3, 3:2, 16:9, 2:1, 21:9, 7:5, 5:7) | no | Output image shape. |
| resolution | string (enum) (1K, 1.5K, 2K, 4K) | no | Output size tier: 1K ≈ 1 MP, 1.5K ≈ 2.25 MP, 2K ≈ 4 MP, 4K ≈ 16 MP. |

```bash
curl -X POST https://cheapergen.com/api/v1/run/bfl/flux-3/edit \
  -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "prompt": "Turn image 1 into the style of image 2; keep the composition and the people unchanged",
  "image_urls": [
    "https://cdn.cheapergen.ai/samples/portrait.jpg"
  ],
  "aspect_ratio": "1:1",
  "resolution": "1K"
}'
```

## 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 3 priced?**
FLUX 3 is billed per image by resolution tier — 1K, 1.5K, 2K or 4K. The prompt and reference images are free, and editing costs the same as generation. Failed generations are not charged.

**Is this the official FLUX 3?**
Yes. Requests run on Black Forest Labs' FLUX 3 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 3 is developed by Black Forest Labs. Cheaper Gen. provides API access and does not own the model.