---
title: FLUX.1 Expand [pro] | Runware Docs
url: https://runware.ai/docs/models/bfl-flux-1-expand-pro
description: High fidelity FLUX outpainting for seamless image expansion
---
# FLUX.1 Expand [pro]

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

FLUX.1 Expand [pro] is an outpainting model that extends images beyond their original frame while preserving structure, lighting, and style. It supports controlled expansion from real or generated inputs and integrates into image editing or generative workflows that need precise, coherent borders.

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

## Pricing

$0.05 from, per run · ~18s per request

**Measured runs**

- 1K expansion · 50 steps: `$0.05` (~23s)
- 0.5K expansion · 50 steps: `$0.05` (~31s)
- 2K expansion · 50 steps: `$0.05` (~24s)
- 4K expansion · 50 steps: `$0.05` (~22s)

**4 example generations**

- [expand](https://runware.ai/docs/models/bfl-flux-1-expand-pro/examples#example-meteorite-conservation-magazine-opener): `$0.05` (~15s)
- [expand](https://runware.ai/docs/models/bfl-flux-1-expand-pro/examples#example-pipe-organ-restoration-editorial-panorama): `$0.05` (~14s)
- [expand](https://runware.ai/docs/models/bfl-flux-1-expand-pro/examples#example-avalanche-patrol-team-portrait): `$0.05` (~14s)
- [expand](https://runware.ai/docs/models/bfl-flux-1-expand-pro/examples#example-monsoon-observatory-campaign-banner): `$0.05` (~14s)

billed by compute time, so a request costs what it took · 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-expand-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-expand-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-expand-pro#request-outputtype)

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

Image output type.

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

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

- **Type**: `boolean`

Include task cost in the response.

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

**Core Parameters**

Primary parameters that define the task output.

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

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

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-expand-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)

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

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

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-expand-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)

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

- **Path**: `outpaint.top`
- **Type**: `object (4 properties)`
- **Required**: true

Pixel extensions for each boundary direction of the source image. At least one direction is required.

**Learn more** (1 resource):

- [Image Outpainting: Outpaint Defining The Expansion](https://runware.ai/docs/learn/image-outpainting#outpaint-defining-the-expansion) (learn)

#### [top](https://runware.ai/docs/models/bfl-flux-1-expand-pro#request-outpaint-top)

- **Path**: `outpaint.top`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `2048`
- **Step**: `64`

Number of pixels to extend to the top.

#### [bottom](https://runware.ai/docs/models/bfl-flux-1-expand-pro#request-outpaint-bottom)

- **Path**: `outpaint.bottom`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `2048`
- **Step**: `64`

Number of pixels to extend to the bottom.

#### [left](https://runware.ai/docs/models/bfl-flux-1-expand-pro#request-outpaint-left)

- **Path**: `outpaint.left`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `2048`
- **Step**: `64`

Number of pixels to extend to the left.

#### [right](https://runware.ai/docs/models/bfl-flux-1-expand-pro#request-outpaint-right)

- **Path**: `outpaint.right`
- **Type**: `integer`
- **Min**: `0`
- **Max**: `2048`
- **Step**: `64`

Number of pixels to extend to the right.

**Features**

Standalone addons and post-processing features.

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

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

UUID of the output image.

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

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

URL of the output image.

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

- **Type**: `string`

Base64-encoded image data.

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

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

Data URI of the output image.

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

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

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

- **Type**: `float`

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

## Examples

### expand (expand)

![Meteorite Conservation Magazine Opener](https://assets.runware.ai/examples/bfl-flux-1-expand-pro/19182cc9-bcd8-4242-8251-7d41b59ed0c8.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "552eb39a-fa76-478b-b98a-edfaa4e8f319",
  "model": "bfl:1@3",
  "positivePrompt": "Extend the source photograph horizontally into a complete planetary-materials conservation laboratory for a wide science magazine opener. Preserve the conservator, meteorite, foam tray, workbench, pose, facial features, clothing, proportions, camera height, lens perspective, lighting direction, and documentary photographic style exactly as shown. Continue the stainless-steel bench naturally beyond both original edges. Reveal a meticulous working laboratory with matte gray cabinetry, a glass desiccator containing several small labeled-but-unreadable rock samples, precision calipers, a compact binocular microscope, archival specimen drawers, anti-static mats, pale storage boxes, and a wheeled instrument cart. Add a restrained glimpse of an amber-lit humidity chamber on the far left and neatly arranged mineral sample shelves on the far right. Match the source's cool fluorescent overhead light, subtle reflections, realistic shadows, moderate depth of field, and neutral color rendering; let the meteorite's oxidized rust and umber tones remain the visual accent. Keep the room credible, orderly, and actively used rather than futuristic or theatrical. Balanced editorial composition with generous uncluttered laboratory wall space around the central subject. Seamless photorealistic continuation with no visible borders, duplicated objects, warped furniture, added people, logos, captions, or on-image text.",
  "outpaint": {
    "top": 256,
    "bottom": 256,
    "left": 512,
    "right": 512
  },
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/dce387fa-cd2d-4f63-854d-0ef773174c2a.jpg"
  }
}
```

---

### expand (expand)

![Pipe Organ Restoration Editorial Panorama](https://assets.runware.ai/examples/bfl-flux-1-expand-pro/530d1086-c74b-488b-9aa2-fa0427aff832.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "7bd3e475-d667-49f9-a1f3-237ca7295388",
  "model": "bfl:1@3",
  "positivePrompt": "Outpaint the source photograph horizontally into a seamless 2:1 editorial panorama while preserving the central organ restorer, her pose, face, clothing, tuning tool and pipe exactly as shown. Continue the historic workshop naturally beyond both original edges with correct eye-level perspective: on the left, a tall mullioned window casting the same warm directional light across a walnut workbench, neatly arranged leather bellows tools, calipers, cotton gloves and several horizontal wooden pipes awaiting repair; on the right, receding ranks of burnished tin and dark wooden organ pipes, a rolling library ladder, labeled archival drawers without legible writing, and part of an open organ wind-chest. Maintain consistent timber architecture, realistic scale, lens character, shadows, grain and shallow-to-moderate depth of field. Refined cultural-heritage magazine photography, quiet and meticulous mood, muted pewter, aged brass, walnut brown and indigo palette. Balanced panoramic composition with the craftsperson remaining the clear focal point. No duplicated people, no extra limbs, no warped pipes, no modern machinery, no signage, no logos, no added text.",
  "outpaint": {
    "left": 512,
    "right": 512,
    "top": 256,
    "bottom": 256
  },
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/7106fb71-4e64-45b4-b176-43ee4780b0c4.jpg"
  }
}
```

---

### expand (expand)

![Avalanche Patrol Team Portrait](https://assets.runware.ai/examples/bfl-flux-1-expand-pro/e4ed0dbf-03db-41e1-9f04-670db23ff8de.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "677c6c45-32cb-47ae-b78f-caccd3dd6be2",
  "model": "bfl:1@3",
  "positivePrompt": "Naturally extend the existing documentary group portrait beyond its original frame and preserve every visible patrol member, their faces, uniforms, poses, proportions, and spacing. In the newly revealed area beside the kneeling handler, add one alert avalanche rescue dog: a medium-sized golden retriever sitting calmly in the snow, wearing a practical burnt-orange search-and-rescue harness with reflective trim. The handler's lowered gloved hand should rest naturally near the dog's shoulder, making the dog feel like an original member of the group. Continue the packed snow, rescue-hut exterior, snow-dusted fir trees, and muted alpine ridgeline seamlessly into the expanded area. Match the source camera height, lens perspective, overcast winter daylight, restrained fill flash, cool blue-gray shadows, crisp editorial detail, and understated annual-report aesthetic. Maintain a credible professional team portrait with realistic paw placement, harness construction, fur texture, footprints, contact shadows, and gentle snow compression beneath the dog. No lettering, logos, borders, collage seams, or duplicated people.",
  "outpaint": {
    "top": 256,
    "bottom": 256,
    "left": 512,
    "right": 512
  },
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/6a85de55-37f1-404f-b0ef-89725a085489.jpg"
  }
}
```

---

### expand (expand)

![Monsoon Observatory Campaign Banner](https://assets.runware.ai/examples/bfl-flux-1-expand-pro/f38556e1-f181-4c37-a897-98b68dc2cc48.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "7fb2e9e7-31c3-4e13-81df-08924fd7e856",
  "model": "bfl:1@3",
  "positivePrompt": "Extend the source photograph into a wide panoramic campaign image for an astronomical observatory's summer night program. Preserve the exact white observatory dome, entrance, proportions, camera height, 50mm perspective, post-rain blue-hour lighting, realistic materials, and restrained documentary photographic style. Continue the rust-red Arizona hillside naturally beyond the original frame with wet gravel, shallow reflective puddles, creosote bushes, ocotillo, and scattered saguaros. Broaden the indigo sky into a dramatic but credible late-monsoon dusk: a retreating charcoal storm shelf on the distant horizon, a subtle rain shaft far away, thin breaks revealing the first stars, and a faint warm afterglow beneath the clouds. Extend the observatory's warm practical lights and their reflections consistently into the surrounding path. Create a spacious, sophisticated panoramic composition with strong environmental context and quiet anticipation, using deep indigo, oxidized red earth, muted sage, and small amber highlights. Photorealistic editorial architecture photography, natural atmospheric depth, no added lettering or signage.",
  "outpaint": {
    "top": 256,
    "bottom": 256,
    "left": 512,
    "right": 512
  },
  "providerSettings": {
    "bfl": {
      "promptUpsampling": true
    }
  },
  "inputs": {
    "seedImage": "https://assets.runware.ai/assets/inputs/569c461c-150c-4d20-b5e3-ba4ead859f3a.jpg"
  }
}
```