---
title: FLUX.2 [pro] | Runware Docs
url: https://runware.ai/docs/models/bfl-flux-2-pro
description: High control FLUX.2 Pro image generation and editing
---
# FLUX.2 [pro]

![FLUX.2 [pro]](https://assets.runware.ai/covers/bfl-flux-2-pro.jpg)

FLUX.2 [pro] is a flow-matching latent transformer for precise text-to-image synthesis and reference-guided editing. It supports multi image references, 4MP outputs, and Mistral-based text conditioning for controllable composition and robust iterative edits that preserve structure.

- **Status**: live
- **ID**: `bfl:5@1`
- Try in Playground
- **Creator**: Black Forest Labs
- **Release Date**: November 26, 2025
- **Zero Data Retention**: Yes
- **Capabilities**: Text to Image, Image to Image, Edit, Checkpoint

## Pricing

$0.03 from, per output megapixel · ~20s per request

**Rates**

- First megapixel out · per output megapixel: `$0.03`
- Each further megapixel outper output megapixel · beyond 1: `$0.015`
- Input megapixel · per input megapixel: `$0.015`

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/bfl-flux-2-pro/examples#example-aircraft-deicing-operations-blog-hero) · 1536×1024: `$0.045` (~14s)
- [text-to-image](https://runware.ai/docs/models/bfl-flux-2-pro/examples#example-radio-telescope-farewell-invitation) · 1536×1024: `$0.045` (~17s)
- [reference-to-image](https://runware.ai/docs/models/bfl-flux-2-pro/examples#example-offshore-wind-instructor-persona-portrait) · 1024×1536: `$0.075` (~23s)
- [reference-to-image](https://runware.ai/docs/models/bfl-flux-2-pro/examples#example-art-deco-moth-wall-print) · 1024×1536: `$0.075` (~23s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

`width` and `height` must be used together.

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/bfl-flux-2-pro#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/bfl-flux-2-pro#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/bfl-flux-2-pro#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/bfl-flux-2-pro#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/bfl-flux-2-pro#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/bfl-flux-2-pro#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/bfl-flux-2-pro#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/bfl-flux-2-pro#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/bfl-flux-2-pro#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/bfl-flux-2-pro#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/bfl-flux-2-pro#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/bfl-flux-2-pro#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/bfl-flux-2-pro#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/bfl-flux-2-pro#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `9`

List of reference images (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/bfl-flux-2-pro#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `bfl:5@1`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/bfl-flux-2-pro#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `1`
- **Max**: `32000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/bfl-flux-2-pro#request-width)

- **Type**: `integer`
- **Required**: true
- **Min**: `256`
- **Max**: `2048`
- **Step**: `16`

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/bfl-flux-2-pro#request-height)

- **Type**: `integer`
- **Required**: true
- **Min**: `256`
- **Max**: `2048`
- **Step**: `16`

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [seed](https://runware.ai/docs/models/bfl-flux-2-pro#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `9223372036854776000`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Learn more** (1 resource):

- [Seed](https://runware.ai/docs/learn/seed) (learn)

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/bfl-flux-2-pro#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

**Provider Settings**

Parameters specific to this model provider. These must be nested inside the \`providerSettings.bfl\` object.

### [safetyTolerance](https://runware.ai/docs/models/bfl-flux-2-pro#request-providersettings-bfl-safetytolerance)

- **Path**: `providerSettings.bfl.safetyTolerance`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `5`
- **Default**: `2`

Tolerance level for content moderation. Lower values are stricter; higher values are more permissive.

## Response Parameters

### [taskType](https://runware.ai/docs/models/bfl-flux-2-pro#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/bfl-flux-2-pro#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/bfl-flux-2-pro#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/bfl-flux-2-pro#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/bfl-flux-2-pro#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/bfl-flux-2-pro#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [seed](https://runware.ai/docs/models/bfl-flux-2-pro#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/bfl-flux-2-pro#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/bfl-flux-2-pro#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-image (text-to-image)

![Aircraft Deicing Operations Blog Hero](https://assets.runware.ai/examples/bfl-flux-2-pro/122144ce-3b04-40a0-bc30-f2f0ba927b17.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "c9a92046-9c0f-4cf2-8e24-9156602ed002",
  "model": "bfl:5@1",
  "positivePrompt": "Visually striking editorial photograph for an aviation operations blog hero: an airport deicing technician in a bright safety-orange insulated suit operating from an elevated boom basket at night, spraying a powerful arc of pale mint-green deicing fluid across the frost-covered wing of a large passenger aircraft. Fine snow blows sideways through the floodlights, the wet aluminum skin gleams with reflections, and mist blooms around the wing like illuminated vapor. Compose the worker and basket prominently in the right third, with the aircraft wing creating a strong diagonal toward the lower left and clean dark-blue negative space in the upper left for an editorial headline added later. Low three-quarter viewpoint from the tarmac, readable silhouette at thumbnail size, crisp documentary realism, dramatic cobalt-blue night atmosphere, amber ramp lights, orange workwear and mint spray, subtle film grain, high detail, urgent but professional mood. No visible airline branding, logos, lettering, watermark, border, interface or on-image text.",
  "width": 1536,
  "height": 1024
}
```

---

### text-to-image (text-to-image)

![Radio Telescope Farewell Invitation](https://assets.runware.ai/examples/bfl-flux-2-pro/afb2a93d-ce75-4e08-8b11-5c7ef166c32f.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "5bc5c2f0-7b00-48fb-a7f2-58ff614df741",
  "model": "bfl:5@1",
  "positivePrompt": "Create a finished landscape event invitation, edge-to-edge artwork rather than a photographed card or mockup. Subject: a monumental radio telescope at a high-desert observatory during its final sunset, the parabolic dish tilted toward the sky and occupying the right two-thirds of the composition. Art direction combines a precise cyanotype engineering diagram with sophisticated two-color letterpress: deep ultramarine field, chalk-white technical linework, and one vivid safety-orange sun touching the horizon. Fine antenna schematics, calibration marks, and restrained star-chart dots form an elegant border. Subtle paper grain and slightly imperfect ink registration add tactile character without reducing legibility. Quiet, ceremonial, intelligent mood; crisp twilight rim lighting on the dish; generous negative space on the left for typography. Set the following text exactly, with flawless spelling and a clear modernist hierarchy: “LAST LIGHT” as the large headline, then “A FAREWELL UNDER THE STARS”, then “CELEBRATING 40 YEARS OF ARRAY 7”, followed by “18 OCTOBER 2026 · 6:30 PM” and “MESA MERIDIAN OBSERVATORY”. Add the small closing line “DINNER · STORIES · FINAL SKY SCAN”. Use condensed uppercase sans-serif lettering with wide tracking, clean alignment, and excellent readability. No extra words, no logos, no people, no envelopes, no table surface, no frame, no UI.",
  "width": 1536,
  "height": 1024
}
```

---

### reference-to-image (reference-to-image)

![Offshore Wind Instructor Persona Portrait](https://assets.runware.ai/examples/bfl-flux-2-pro/f2266fd4-ef21-4355-8150-d89d61c764e7.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "b53032fe-f319-4a50-8d82-08d461db877b",
  "model": "bfl:5@1",
  "positivePrompt": "Create a finished vertical environmental persona portrait for an offshore wind safety training program. Use reference image 1 to preserve the instructor's recognizable identity: the same late-40s woman, facial proportions, gray-green eyes, freckles, notched left eyebrow, silver-streaked dark braid and calm, capable demeanor. Use reference image 2 for the exact workwear design and color details: mustard flotation jacket with asymmetric black storm flap, three reflective forearm bars, turquoise helmet with scratched rectangular headlamp, black radio harness, charcoal bib trousers and red fall-arrest lanyard. Place her in a completely new composition inside a practical wind-turbine nacelle training bay, standing three-quarter length beside an open yaw-drive housing, one gloved hand resting on the metal casing and the helmet held beneath her other arm so her face remains unobstructed. She looks directly into the camera with patient authority, like an experienced instructor about to begin a safety demonstration. Documentary editorial photography rather than action spectacle; realistic machinery, cable runs and maintenance markings softly out of focus behind her. Cool cyan industrial daylight from the left balanced by a warm amber inspection lamp from the right, restrained slate-blue, mustard and oxidized-metal palette, crisp facial detail, natural skin texture, subtle grease wear on the jacket cuffs, 50mm lens perspective, eye-level framing, generous breathing room above the head, no logos, no legible text, no interface, no poster typography.",
  "width": 1024,
  "height": 1536,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/be8eec20-5a5d-4778-b465-f11700f99278.jpg",
      "https://assets.runware.ai/assets/inputs/5379079d-286f-48f1-96ee-8d077b02a3e1.jpg"
    ]
  }
}
```

---

### reference-to-image (reference-to-image)

![Art Deco Moth Wall Print](https://assets.runware.ai/examples/bfl-flux-2-pro/e48e332e-545f-493f-a619-6feeed8478d5.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "316f463e-0ad0-4a41-9cbf-b467e97ed9df",
  "model": "bfl:5@1",
  "positivePrompt": "Create a finished vertical print-on-demand wall artwork that merges the recognizable Atlas moth from reference image 1 with the ornamental structure of the bronze elevator grille from reference image 2. Place one large, perfectly centered moth with wings fully spread, preserving its distinctive hooked upper-wing tips, rust-and-cream bands, black edging, and translucent triangular windows. Recompose the grille's stepped fan motifs and slender geometric bars into a precise symmetrical Art Deco framework behind and around the moth, with the bars radiating outward without obscuring its silhouette. Render the image as an elegant hand-pulled linocut and metallic foil print: matte oxblood background, warm parchment moth markings, deep charcoal shadows, aged copper linework, and restrained verdigris accents. Crisp carved contours, subtle ink texture, balanced negative space, refined natural-history detail, stately and quietly dramatic mood. Full-bleed standalone artwork, no frame, no room mockup, no typography, no labels, no border, portrait composition.",
  "width": 1024,
  "height": 1536,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/f5f27a7f-fa3b-4ba6-a84c-a831ad6f0b58.jpg",
      "https://assets.runware.ai/assets/inputs/17cfd562-933f-402c-8d6a-af1cef134cd7.jpg"
    ]
  }
}
```