black-forest-labs / flux-fill-pro

Professional inpainting and outpainting model with state-of-the-art performance. Edit or extend images with natural, seamless results.

Warm

Public
1.6M runs
$0.05 per output image
Commercial use
License

Iterate in playground

Run with an API

This model uses a mask. Visit the new playground to try this model with our mask editing tool.

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

Text prompt for image generation

image

*file

Preview

The image to inpaint. Can contain an alpha mask. Must be jpeg, png, gif, or webp.

mask

file

Preview

A black-and-white image that describes the part of the image to inpaint. Black areas will be preserved while white areas will be inpainted. Must have the same size as image. Optional if you provide an alpha mask in the original image. Must be jpeg, png, gif, or webp.

outpaint

string

A quick option for outpainting an input image. Mask will be ignored.

Default: "None"

seed

integer

Random seed. Set for reproducible generation

steps

integer

(minimum: 15, maximum: 50)

Number of diffusion steps. Higher values yield finer details but increase processing time.

Default: 50

prompt_upsampling

boolean

Automatically modify the prompt for more creative generation

Default: false

guidance

number

(minimum: 1.5, maximum: 100)

Controls the balance between adherence to the text prompt and image quality/diversity. Higher values make the output more closely match the prompt but may reduce overall image quality. Lower values allow for more creative freedom but might produce results less relevant to the prompt.

Default: 60

safety_tolerance

integer

(minimum: 1, maximum: 6)

Safety tolerance, 1 is most strict and 6 is most permissive

Default: 2

output_format

string

Format of the output images.

Default: "jpg"

Run this model in Node.js with one line of code:

npx create-replicate --model=black-forest-labs/flux-fill-pro

or set up a project from scratch

Install Replicate’s Node.js client library:

npm install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import and set up the client:

import Replicate from "replicate";
import fs from "node:fs";

const replicate = new Replicate({
  auth: process.env.REPLICATE_API_TOKEN,
});

Run black-forest-labs/flux-fill-pro using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  mask: "https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png",
  image: "https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg",
  steps: 50,
  prompt: "movie poster says \"FLUX FILL\"",
  guidance: 60,
  outpaint: "None",
  output_format: "jpg",
  safety_tolerance: 2,
  prompt_upsampling: false
};

const output = await replicate.run("black-forest-labs/flux-fill-pro", { input });

// To access the file URL:
console.log(output.url()); //=> "http://example.com"

// To write the file to disk:
fs.writeFile("my-image.png", output);

To learn more, take a look at the guide on getting started with Node.js.

Install Replicate’s Python client library:

pip install replicate

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Import the client:

import replicate

Run black-forest-labs/flux-fill-pro using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

output = replicate.run(
    "black-forest-labs/flux-fill-pro",
    input={
        "mask": "https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png",
        "image": "https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg",
        "steps": 50,
        "prompt": "movie poster says \"FLUX FILL\"",
        "guidance": 60,
        "outpaint": "None",
        "output_format": "jpg",
        "safety_tolerance": 2,
        "prompt_upsampling": False
    }
)
print(output)

To learn more, take a look at the guide on getting started with Python.

Set the REPLICATE_API_TOKEN environment variable:

export REPLICATE_API_TOKEN=<paste-your-token-here>

Find your API token in your account settings.

Run black-forest-labs/flux-fill-pro using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

curl -s -X POST \
  -H "Authorization: Bearer $REPLICATE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Prefer: wait" \
  -d $'{
    "input": {
      "mask": "https://replicate.delivery/pbxt/M0gpLCYdCLbnhcz95Poy66q30XW9VSCN65DoDQ8IzdzlQonw/kill-bill-mask.png",
      "image": "https://replicate.delivery/pbxt/M0gpKVE9wmEtOQFNDOpwz1uGs0u6nK2NcE85IihwlN0ZEnMF/kill-bill-poster.jpg",
      "steps": 50,
      "prompt": "movie poster says \\"FLUX FILL\\"",
      "guidance": 60,
      "outpaint": "None",
      "output_format": "jpg",
      "safety_tolerance": 2,
      "prompt_upsampling": false
    }
  }' \
  https://api.replicate.com/v1/models/black-forest-labs/flux-fill-pro/predictions

To learn more, take a look at Replicate’s HTTP API reference docs.

Output

Generated in

8.2 seconds

Tweak it Report

Examples

View more examples

Pricing

Model pricing for black-forest-labs/flux-fill-pro. Looking for volume pricing? Get in touch.

$0.05

per output image

or around 20 images for $1

Official models are always on, maintained, and have predictable pricing. Learn more.

Check out our docs for more information about how pricing works on Replicate.

Readme

FLUX.1 Fill [pro]

State-of-the-art inpainting and outpainting model. Edit or extend images with natural, seamless results.

FLUX.1 Fill [pro] makes editing images feel natural. Paint over what you want to change, describe what you want instead, and get results that blend perfectly with the original.

The model understands complex scenes and text, and maintains consistency across edits. Whether you’re removing objects, adding new elements, or expanding the canvas, Fill [pro] preserves lighting, perspective, and context.

License

By using FLUX.1 Fill [pro] through Replicate you agree to the Black Forest Labs API agreement and the Black Forest Labs Terms of Service.