Official

black-forest-labs / flux-pro

State-of-the-art image generation with top of the line prompt following, visual quality, image detail and output diversity.

Warm

Public
10.1M runs
$0.055 per image
Commercial use
License

Run with an API

Blog post: Learn about training with Flux Read the blog

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

The world's largest black forest cake, the size of a building, surrounded by trees of the black forestThe world's largest black forest cake, the size of a building, surrounded by trees of the black forest

Text prompt for image generation

image_prompt

file

Image to use with Flux Redux. This is used together with the text prompt to guide the generation towards the composition of the image_prompt. Must be jpeg, png, gif, or webp.

aspect_ratio

string

Aspect ratio for the generated image

Default: "1:1"

width

integer

(minimum: 256, maximum: 1440)

Width of the generated image in text-to-image mode. Only used when aspect_ratio=custom. Must be a multiple of 32 (if it's not, it will be rounded to nearest multiple of 32). Note: Ignored in img2img and inpainting modes.

height

integer

(minimum: 256, maximum: 1440)

Height of the generated image in text-to-image mode. Only used when aspect_ratio=custom. Must be a multiple of 32 (if it's not, it will be rounded to nearest multiple of 32). Note: Ignored in img2img and inpainting modes.

steps

integer

(minimum: 1, maximum: 50)

Number of diffusion steps

Default: 25

guidance

number

(minimum: 2, maximum: 5)

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: 3

interval

number

(minimum: 1, maximum: 4)

Interval is a setting that increases the variance in possible outputs letting the model be a tad more dynamic in what outputs it may produce in terms of composition, color, detail, and prompt interpretation. Setting this value low will ensure strong prompt following with more consistent outputs, setting it higher will produce more dynamic or varied outputs.

Default: 2

safety_tolerance

integer

(minimum: 1, maximum: 6)

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

Default: 2

prompt_upsampling

boolean

Automatically modify the prompt for more creative generation

Default: false

seed

integer

Random seed. Set for reproducible generation

output_format

string

Format of the output images.

Default: "webp"

output_quality

integer

(minimum: 0, maximum: 100)

Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs

Default: 80

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

npx create-replicate --model=black-forest-labs/flux-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";

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

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

const input = {
  steps: 25,
  width: 1024,
  height: 1024,
  prompt: "The world's largest black forest cake, the size of a building, surrounded by trees of the black forest",
  guidance: 3,
  interval: 2,
  aspect_ratio: "1:1",
  output_format: "webp",
  output_quality: 80,
  safety_tolerance: 2,
  prompt_upsampling: false
};

const output = await replicate.run("black-forest-labs/flux-pro", { input });
console.log(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-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-pro",
    input={
        "steps": 25,
        "width": 1024,
        "height": 1024,
        "prompt": "The world's largest black forest cake, the size of a building, surrounded by trees of the black forest",
        "guidance": 3,
        "interval": 2,
        "aspect_ratio": "1:1",
        "output_format": "webp",
        "output_quality": 80,
        "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-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": {
      "steps": 25,
      "width": 1024,
      "height": 1024,
      "prompt": "The world\'s largest black forest cake, the size of a building, surrounded by trees of the black forest",
      "guidance": 3,
      "interval": 2,
      "aspect_ratio": "1:1",
      "output_format": "webp",
      "output_quality": 80,
      "safety_tolerance": 2,
      "prompt_upsampling": false
    }
  }' \
  https://api.replicate.com/v1/models/black-forest-labs/flux-pro/predictions

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

Output

Generated in

14.1 seconds

Tweak it ShareReport

Examples

View more examples

Pricing

This model is priced by how many images are generated.

Type	Per unit	Per $1
Output	$0.055 / image or 18 images / $1

For example, generating 100 images should cost around $5.50.

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

Readme

FLUX.1 [pro] is the best of FLUX.1, offering state-of-the-art performance image generation with top of the line prompt following, visual quality, image detail and output diversity.

All FLUX.1 model variants support a diverse range of aspect ratios and resolutions in 0.1 and 2.0 megapixels

All public FLUX.1 models are based on a hybrid architecture of multimodal and parallel diffusion transformer blocks and scaled to 12B parameters. We improve over previous state-of-the-art diffusion models by building on flow matching, a general and conceptually simple method for training generative models, which includes diffusion as a special case. In addition, we increase model performance and improve hardware efficiency by incorporating rotary positional embeddings and parallel attention layers.

License

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