---
title: FLUX.1 Kontext [max] | Runware Docs
url: https://runware.ai/docs/models/bfl-flux-1-kontext-max
description: High fidelity FLUX.1 Kontext max for precise image edits
---
# FLUX.1 Kontext [max]

![FLUX.1 Kontext [max]](https://assets.runware.ai/covers/bfl-flux-1-kontext-max.jpg)

FLUX.1 Kontext [max] is a high quality text to image model for production workflows. It focuses on prompt accuracy, sharp local edits, and premium typography rendering. Use it for detailed visual design, branded visuals, and consistent character safe image generation.

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

## Pricing

$0.08 per run · ~12s per request

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/bfl-flux-1-kontext-max/examples#example-rooftop-beekeeping-suit-try-on) · 1392×752: `$0.08` (~9s)
- [reference-to-image](https://runware.ai/docs/models/bfl-flux-1-kontext-max/examples#example-maritime-auction-catalog-portrait) · 880×1184: `$0.08` (~12s)
- [text-to-image](https://runware.ai/docs/models/bfl-flux-1-kontext-max/examples#example-opera-costume-atelier-panorama) · 1392×752: `$0.08` (~13s)
- [reference-to-image](https://runware.ai/docs/models/bfl-flux-1-kontext-max/examples#example-alpine-observatory-winter-campaign-hero) · 880×1184: `$0.08` (~17s)

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.

---

The following dimension combinations are supported:

| Configuration | Dimensions |
| --- | --- |
| `1K (21:9)` | `1568x672` |
| `1K (16:9)` | `1392x752` |
| `1K (4:3)` | `1184x880` |
| `1K (3:2)` | `1248x832` |
| `1K (1:1)` | `1024x1024` |
| `1K (2:3)` | `832x1248` |
| `1K (3:4)` | `880x1184` |
| `1K (9:16)` | `752x1392` |
| `1K (9:21)` | `672x1568` |

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/bfl-flux-1-kontext-max#request-tasktype)

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

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#request-outputtype)

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

Image output type.

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

### [outputFormat](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#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-1-kontext-max#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-1-kontext-max#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-1-kontext-max#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-1-kontext-max#request-safety)

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

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#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-1-kontext-max#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#request-inputs-referenceimages)

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

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-1-kontext-max#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `bfl:4@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-1-kontext-max#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `3000`

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-1-kontext-max#request-width)

- **Type**: `integer`
- **Required**: true
- **Paired with**: height

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-1-kontext-max#request-height)

- **Type**: `integer`
- **Required**: true
- **Paired with**: width

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-1-kontext-max#request-seed)

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

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

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#request-advancedfeatures-watermark-text)

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

Watermark text.

#### [image](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#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-1-kontext-max#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-1-kontext-max#request-advancedfeatures-watermark-fontcolor)

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

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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.

### [promptUpsampling](https://runware.ai/docs/models/bfl-flux-1-kontext-max#request-providersettings-bfl-promptupsampling)

- **Path**: `providerSettings.bfl.promptUpsampling`
- **Type**: `boolean`

Enable automatic enhancement and expansion of the input prompt.

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

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

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

## Response Parameters

### [taskType](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#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-1-kontext-max#response-imageuuid)

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

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/bfl-flux-1-kontext-max#response-imageurl)

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

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/bfl-flux-1-kontext-max#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/bfl-flux-1-kontext-max#response-imagedatauri)

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

Data URI of the output image.

### [seed](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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-1-kontext-max#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/bfl-flux-1-kontext-max#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)

![Rooftop Beekeeping Suit Try-On](https://assets.runware.ai/examples/bfl-flux-1-kontext-max/54df8801-9beb-4428-b42b-ebedfb617aee.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "bed88c34-5c77-4a8a-98e6-85faac65a547",
  "model": "bfl:4@1",
  "positivePrompt": "Create a premium landscape apparel try-on image for a technical beekeeping suit. Show one adult female beekeeper, around 50 years old, standing full-length on a lush urban rooftop apiary at early morning. She is wearing a distinctive celadon-green one-piece beekeeping suit with coral-orange reinforced knees and elbows, an articulated waist, sealed ankle cuffs, cream leather gauntlet gloves, sturdy tan work boots, and a structured round veil hood made from fine black mesh. Make the garment construction exceptionally clear and commercially credible: visible double stitching, matte ripstop texture, practical zipped pockets, ventilation panels, reinforced seams, and realistic folds around the moving body. The fit should look protective yet tailored, with accurate anatomy and natural posture. She gently lifts one wooden honey frame at chest height while inspecting it through the veil; a few bees hover nearby without obscuring the outfit.\n\nSet the scene among orderly cedar hives, flowering lavender, rooftop vegetable beds, stainless steel watering cans, and the soft silhouette of a contemporary city beyond the parapet. Warm low sunlight catches amber honeycomb and the edges of the mesh veil, contrasting with cool blue morning shadows and dew-covered greenery. Compose as a wide editorial field image with the beekeeper slightly right of center, her entire outfit visible from hood to boots, and enough environmental context on the left to establish the rooftop pollinator farm. Eye-level camera, 50mm documentary-fashion perspective, crisp garment detail, controlled shallow depth of field, natural skin and hands, realistic bees, refined color grading, calm capable mood. Photorealistic outdoor workwear campaign photography, not a costume or fantasy scene. No logos, no lettering, no signage, no additional people, no duplicated tools, no border or interface.",
  "width": 1392,
  "height": 752,
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true
    }
  }
}
```

---

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

![Opera Costume Atelier Panorama](https://assets.runware.ai/examples/bfl-flux-1-kontext-max/db3aad81-20c7-4fa4-832a-09311a692f71.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "84f567b2-3886-4131-8deb-60773d1aa678",
  "model": "bfl:4@1",
  "positivePrompt": "Create the finished panoramic outpaint of an intimate portrait-oriented documentary photograph, expanding the scene naturally far beyond the original center composition into a 1392x752 landscape editorial image. In the center third, a senior opera costume dyer wearing a dark indigo work apron carefully gathers an enormous pleated sea-green silk cape across a waist-high cutting table. Preserve the feeling of a tightly observed human moment while revealing the full working atelier on both sides. Extend left into a deep stainless-steel dye sink, enamel buckets, clipped fabric swatches, wet turquoise silk and a small cloud of steam caught by window light. Extend right into rolling garment racks holding elaborate unfinished costumes in gradients of celadon, coral and smoky violet, with labeled kraft-paper pattern pieces, spools of thread and brass scissors on a worn oak workbench. The architecture must continue coherently across the entire frame: high old plaster walls, exposed pipes, tall north-facing windows and a scuffed checkerboard linoleum floor with correct perspective. Sophisticated backstage realism, tactile fabric detail, restrained theatrical color, soft overcast daylight mixed with warm practical lamps, subtle 35mm grain, deep but gentle shadows, editorial photography for a prestigious performing-arts publication. Wide visual rhythm with meaningful environmental storytelling at both edges, subject remaining the focal point, natural anatomy and hands, seamless spatial continuity, no visible crop boundary, no borders, no collage effect, no duplicated furniture or people, no signage, logos or on-image text.",
  "width": 1392,
  "height": 752,
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true
    }
  }
}
```

---

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

![Maritime Auction Catalog Portrait](https://assets.runware.ai/examples/bfl-flux-1-kontext-max/f939aa15-d5b2-44e1-b1f2-c0fb4e25e083.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "ba069c5a-b668-4e94-945f-0620cad1c35a",
  "model": "bfl:4@1",
  "positivePrompt": "Use the first reference image as the primary source and preserve the antique diving helmet as the exact recognizable subject: retain its silhouette, proportions, three-quarter orientation, circular glass faceplate, brass hardware, dents, seams, verdigris and distinctive copper patina without redesigning, restoring or replacing any component. Remove only its plain studio background and place the helmet naturally on a blackened oak conservation workbench inside the maritime conservation workshop visually guided by the second reference image. Match the second image's deep teal walls, shadowed specimen cabinetry, subtle industrial window structure, warm amber practical light and quiet museum atmosphere, but keep the surroundings understated and softly out of focus so the helmet remains dominant. Create believable contact, weight and a soft grounded shadow beneath the helmet; add restrained warm edge light across the copper while preserving authentic material texture and neutral color accuracy on the object. Premium specialist-auction catalog photography, elegant and documentary rather than theatrical, crisp subject detail, realistic optics, shallow depth of field, no people, no labels, no lettering, no logo. Compose vertically at 880x1184 with the complete helmet centered slightly below mid-frame, generous dark breathing room above, and no cropping of the object.",
  "width": 880,
  "height": 1184,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/8f275c98-4023-4d85-bb95-2b7ccdf11ceb.jpg",
      "https://assets.runware.ai/assets/inputs/94de3b05-55b1-4aa2-99cb-e0b90c222be9.jpg"
    ]
  }
}
```

---

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

![Alpine Observatory Winter Campaign Hero](https://assets.runware.ai/examples/bfl-flux-1-kontext-max/b3894da7-d498-4654-a3ed-b7b64fad6104.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "a313fc63-ceb8-4391-a93e-3e0e85243895",
  "model": "bfl:4@1",
  "positivePrompt": "Edit the first reference image as the primary source. Transform the same observatory from late-summer daylight into a credible deep-winter blue-hour scene for an alpine astrotourism campaign, using the second reference only as guidance for the wintry environment, cobalt-and-rose palette, snow texture and natural twilight lighting. Preserve the exact observatory architecture, proportions, two recognizable telescope domes, corrugated facade, antenna mast, window placement, camera position, perspective, mountain contours and overall composition from the first image. Replace the grass and exposed ground with deep, wind-sculpted snow that accumulates naturally along roof edges, steps and rocks without obscuring important structural details. Relight the building and landscape with soft cold moonlit ambience, long blue shadows and a faint rose glow at the horizon. Add restrained warm interior light through the existing windows and subtle practical light near the entrance, with physically accurate reflections on snow and metal. Keep the atmosphere crisp, remote and inviting rather than dramatic or fantastical. Premium photorealistic architectural and travel photography, fine material detail, realistic exposure, clean portrait framing with generous sky above the domes, no people, no vehicles, no added structures, no aurora, no lettering, no logos.",
  "width": 880,
  "height": 1184,
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/c273e296-7bf4-4fad-a421-81b9f25241ca.jpg",
      "https://assets.runware.ai/assets/inputs/23a2c46d-468f-449d-ad6d-e6769ae35699.jpg"
    ]
  }
}
```