black-forest-labs / flux-kontext-pro

A state-of-the-art text-based image editing model that delivers high-quality outputs with excellent prompt following and consistent results for transforming images through natural language

Warm

Public
3.7M runs
$0.04 per output image
Commercial use
Weights

Iterate in playground

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

Text description of what you want to generate, or the instruction on how to edit the given image.

input_image

file

Image to use as reference. Must be jpeg, png, gif, or webp.

aspect_ratio

string

Aspect ratio of the generated image. Use 'match_input_image' to match the aspect ratio of the input image.

Default: "match_input_image"

seed

integer

Random seed. Set for reproducible generation

output_format

string

Output format for the generated image

Default: "png"

safety_tolerance

integer

(minimum: 0, maximum: 6)

Safety tolerance, 0 is most strict and 6 is most permissive. 2 is currently the maximum allowed when input images are used.

Default: 2

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

npx create-replicate --model=black-forest-labs/flux-kontext-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-kontext-pro using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  prompt: "Make this a 90s cartoon",
  input_image: "https://replicate.delivery/pbxt/N55l5TWGh8mSlNzW8usReoaNhGbFwvLeZR3TX1NL4pd2Wtfv/replicate-prediction-f2d25rg6gnrma0cq257vdw2n4c.png",
  aspect_ratio: "match_input_image",
  output_format: "jpg",
  safety_tolerance: 2
};

const output = await replicate.run("black-forest-labs/flux-kontext-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-kontext-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-kontext-pro",
    input={
        "prompt": "Make this a 90s cartoon",
        "input_image": "https://replicate.delivery/pbxt/N55l5TWGh8mSlNzW8usReoaNhGbFwvLeZR3TX1NL4pd2Wtfv/replicate-prediction-f2d25rg6gnrma0cq257vdw2n4c.png",
        "aspect_ratio": "match_input_image",
        "output_format": "jpg",
        "safety_tolerance": 2
    }
)
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-kontext-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": {
      "prompt": "Make this a 90s cartoon",
      "input_image": "https://replicate.delivery/pbxt/N55l5TWGh8mSlNzW8usReoaNhGbFwvLeZR3TX1NL4pd2Wtfv/replicate-prediction-f2d25rg6gnrma0cq257vdw2n4c.png",
      "aspect_ratio": "match_input_image",
      "output_format": "jpg",
      "safety_tolerance": 2
    }
  }' \
  https://api.replicate.com/v1/models/black-forest-labs/flux-kontext-pro/predictions

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

Output

Generated in

4.4 seconds

Tweak it Report View full prediction

Examples

View more examples

Pricing

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

$0.04

per output image

or 25 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 Kontext - Text-Based Image Editing

FLUX.1 Kontext is a state-of-the-art image editing model from Black Forest Labs that allows you to edit images using text prompts. It’s the best in class for text-guided image editing and offers superior results compared to other models like OpenAI’s 4o/gpt-image-1.

Available Models

FLUX.1 Kontext [pro]: State-of-the-art performance with high-quality outputs, great prompt following, and consistent results
FLUX.1 Kontext [max]: Premium model with maximum performance and improved typography generation

Coming soon

FLUX.1 Kontext [dev]: An open-weight distilled version

What You Can Do

Kontext excels at:

Style Transfer: Convert photos to different art styles (watercolor, oil painting, sketches)
Object/Clothing Changes: Modify hairstyles, add accessories, change colors
Text Editing: Replace text in signs, posters, and labels
Background Swapping: Change environments while preserving subjects
Character Consistency: Maintain identity across multiple edits

Prompting Best Practices

Be Specific

Use clear, detailed language with exact colors and descriptions
Avoid vague terms like “make it better”
Name subjects directly: “the woman with short black hair” vs. “she”

Preserve Intentionally

Specify what should stay the same: “while keeping the same facial features”
Use “maintain the original composition” to preserve layout
For background changes: “Change the background to a beach while keeping the person in the exact same position”