---
title: FLUX.1 Fill [pro] | Runware Docs
url: https://runware.ai/docs/models/bfl-flux-1-fill-pro
description: FLUX.1 Fill Pro for Precision AI Inpainting Control
---
# FLUX.1 Fill [pro]

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

FLUX.1 Fill Pro provides advanced inpainting and outpainting for real and generated images. Supply an input image, mask, and text prompt. The model fills or extends regions with seamless content that matches context and style. Ideal for edits, layout fixes, and content-aware expansion.

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

## Pricing

$0.05 per run · ~16s per request

**4 example generations**

- [inpaint](https://runware.ai/docs/models/bfl-flux-1-fill-pro/examples#example-boro-textile-collection-panorama) · steps 32: `$0.05` (~17s)
- [inpaint](https://runware.ai/docs/models/bfl-flux-1-fill-pro/examples#example-hydroelectric-intake-tower-night-relight): `$0.05` (~16s)
- [inpaint](https://runware.ai/docs/models/bfl-flux-1-fill-pro/examples#example-taiko-ensemble-press-photo-update) · steps 30: `$0.05` (~16s)
- [inpaint](https://runware.ai/docs/models/bfl-flux-1-fill-pro/examples#example-polar-institute-director-headshot): `$0.05` (~12s)

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

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

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

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

Image output type.

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

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

- **Type**: `boolean`

Include task cost in the response.

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

### [seedImage](https://runware.ai/docs/models/bfl-flux-1-fill-pro#request-inputs-seedimage)

- **Path**: `inputs.seedImage`
- **Type**: `string`
- **Required**: true

Image used as a starting point for the generation (UUID, URL, Data URI, or Base64).

**Learn more** (3 resources):

- [Image To Image: Seed Image The Foundation](https://runware.ai/docs/learn/image-to-image#seed-image-the-foundation) (learn)
- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)
- [Image Outpainting: Seed Image The Starting Point](https://runware.ai/docs/learn/image-outpainting#seed-image-the-starting-point) (learn)

### [maskImage](https://runware.ai/docs/models/bfl-flux-1-fill-pro#request-inputs-maskimage)

- **Path**: `inputs.maskImage`
- **Type**: `string`
- **Required**: true

Image used to specify which areas of the input image should be edited (UUID, URL, Data URI, or Base64). White marks the area to edit, black is preserved.

**Learn more** (1 resource):

- [Image Inpainting: Seed And Mask Image The Foundation](https://runware.ai/docs/learn/image-inpainting#seed-and-mask-image-the-foundation) (learn)

**Core Parameters**

Primary parameters that define the task output.

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

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

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-fill-pro#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)

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

### [steps](https://runware.ai/docs/models/bfl-flux-1-fill-pro#request-steps)

- **Type**: `integer`
- **Min**: `15`
- **Max**: `50`
- **Default**: `20`

Total number of denoising steps. Higher values generally produce more detailed results but take longer.

**Learn more** (1 resource):

- [Steps](https://runware.ai/docs/learn/steps) (learn)

### [CFGScale](https://runware.ai/docs/models/bfl-flux-1-fill-pro#request-cfgscale)

- **Type**: `float`
- **Min**: `1.5`
- **Max**: `100`
- **Step**: `0.01`
- **Default**: `60`

Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt.

**Learn more** (1 resource):

- [Cfg Scale](https://runware.ai/docs/learn/cfg-scale) (learn)

**Features**

Standalone addons and post-processing features.

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

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

Text color in hex format.

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

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

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

- **Type**: `float`

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

## Examples

### inpaint (inpaint)

![Boro Textile Collection Panorama](https://assets.runware.ai/examples/bfl-flux-1-fill-pro/d60a49ea-ea51-457f-8e91-a8b6092cb1b8.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "bee376ea-9b69-4fb5-a46c-66cfa6982617",
  "model": "bfl:1@2",
  "positivePrompt": "Replace the entire neutral-gray matte with a seamless, photorealistic continuation of the antique boro textile visible in the preserved central photograph, converting the narrow source crop into a wide 16:9 museum editorial panorama. Extend the existing patchwork naturally toward every edge: irregular overlapping indigo cotton panels, faded cobalt and deep navy dye, restrained ecru areas, hand-sewn sashiko running stitches, subtle puckering, frayed fibers, repaired seams, and authentic age variation. Match the exact weave scale, camera angle, focus, soft raking light, shadows, color response, and tactile archival-photography character of the preserved center. Continue partial seams and stitch lines across the former matte boundary without visible joins, repetition, borders, frames, or abrupt pattern changes. Keep the composition quiet, scholarly, tactile, and suitable as a premium museum collection hero image. Edge-to-edge textile only, no text, labels, people, tools, display case, wall, or remaining gray matte.",
  "steps": 32,
  "CFGScale": 55,
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true,
      "safetyTolerance": 6
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/104b953d-351a-4f50-aa05-e31fa734931a.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/15c4d516-bb0c-41c9-849d-fe82ba1d4e33.png"
  }
}
```

---

### inpaint (inpaint)

![Hydroelectric Intake Tower Night Relight](https://assets.runware.ai/examples/bfl-flux-1-fill-pro/5715351e-93fc-40d9-b7b2-e782cc1f71c5.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "bdefec21-1539-4ccf-b3bb-feacc6de768b",
  "model": "bfl:1@2",
  "positivePrompt": "Transform only the masked hydroelectric intake tower into a finished nighttime architectural lighting visualization while preserving the surrounding reservoir, horizon, and blue-hour sky exactly as photographed. Retain the tower's precise silhouette, cylindrical geometry, concrete panel seams, narrow windows, parapet, and weathered mineral texture. Relight the entire structure with concealed 2700K amber fixtures producing elegant upward grazing illumination from the base, soft vertical bands that reveal the concrete relief, and a restrained warm glow inside the existing narrow windows. Add subtle cool blue ambient light along the shadowed edges so the tower remains naturally integrated into the blue-hour scene. Use physically plausible falloff, controlled highlights, realistic deep shadows, and museum-grade heritage lighting with no theatrical colors or overexposure. Photorealistic professional architectural photography, refined civic-infrastructure mood, no signage, lettering, people, added structures, or changes outside the masked subject.",
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/719e0949-fbc5-4652-8395-fd016408a4ed.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/f1fa0b78-beb7-4e8c-927f-475c71eed6b0.png"
  }
}
```

---

### inpaint (inpaint)

![Taiko Ensemble Press Photo Update](https://assets.runware.ai/examples/bfl-flux-1-fill-pro/4f6f1a79-cc6d-4464-8bd4-92ab487ca8d7.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "22c20fcb-1484-4e13-a1fa-f387e534937e",
  "model": "bfl:1@2",
  "positivePrompt": "Remove the masked performer at the far right completely and reconstruct the studio set behind them. Replace the entire figure with an uninterrupted continuation of the matte saffron seamless-paper backdrop and floor, matching the existing color, fine paper texture, gentle tonal falloff, lighting, perspective, and natural floor shading. The finished publicity photograph should show only the four-person taiko ensemble grouped on the left, with intentional clean negative space on the right. Preserve every unmasked performer, face, garment, drum, cord, pose, edge, and shadow exactly as photographed. Create a seamless, photorealistic removal with no human fragments, ghosting, duplicated limbs, new props, text, or visible retouching.",
  "steps": 30,
  "CFGScale": 60,
  "providerSettings": {
    "bfl": {
      "promptUpsampling": false,
      "safetyTolerance": 6
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/8b1c25c7-e31c-47ab-8451-3d3fb26d250d.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/dc2710e8-d512-4da9-b336-9dd773da9dba.png"
  }
}
```

---

### inpaint (inpaint)

![Polar Institute Director Headshot](https://assets.runware.ai/examples/bfl-flux-1-fill-pro/dbd9e37c-7dd1-4b22-a6d8-3be92b1fdf19.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "37c1bc34-11b9-4b84-9030-54dc7d9ec363",
  "model": "bfl:1@2",
  "positivePrompt": "Replace only the masked person with a meticulously retouched, publication-ready version of the same woman while preserving the surrounding pale blue-gray studio background exactly. Maintain her unmistakable facial identity, Greenlandic ancestry, age, face shape, brown eyes, nose, mouth, natural asymmetry, short salt-and-pepper hair, direct gaze, calm expression, body proportions, pose, framing, and head position. Create an authoritative but approachable leadership headshot for a polar research institute director, not a fashion portrait. Refine stray hairs while retaining believable individual strands and a natural silver-and-charcoal texture. Apply restrained professional retouching: balanced complexion, softened temporary redness and under-eye darkness, subtle catchlights, clean color, and gently improved contrast while preserving pores, fine lines, sun exposure, and the authentic character of a veteran Arctic field leader. No plastic skin, face reshaping, age reduction, heavy makeup, or glamour styling. Replace the rumpled technical fleece with a precisely tailored deep navy wool blazer over a matte slate-blue fine-gauge crewneck, understated and practical, with realistic seams, folds, and fabric texture. Use soft directional studio light from camera left with delicate fill, natural facial modeling, controlled highlights, and a subtle clean rim along the hair and shoulders that integrates seamlessly with the existing background. Neutral-cool institutional editorial color grade with navy, slate, silver, and pale ice-blue tones. Crisp focus on the eyes, realistic skin and hair, polished medium-format photographic quality. Keep the result as one standalone vertical headshot with no props, logos, badges, text, borders, or added background elements.",
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/7e532244-391d-42cb-8147-6521a8659db4.jpg",
    "maskImage": "https://assets.runware.ai/assets/inputs/7fe9ba3b-8868-43bb-850f-b1c925a9aea9.png"
  }
}
```