Official

black-forest-labs / flux-depth-pro

Professional depth-aware image generation. Edit images while preserving spatial relationships.

Warm

Public
203.4K runs
$0.05 per output image
Commercial use
License

Iterate in playground

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

abstract 3D render with the word "DEPTH"abstract 3D render with the word "DEPTH"

Text prompt for image generation

control_image

*file

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

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, maximum: 100)

Controls the balance between adherence to the text as well as image 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: 15

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-depth-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-depth-pro using Replicate’s API. Check out the model's schema for an overview of inputs and outputs.

const input = {
  steps: 50,
  prompt: "abstract 3D render with the word \"DEPTH\"",
  guidance: 7,
  control_image: "https://replicate.delivery/pbxt/M0ivr5QCMktmdUi3t0TFrKtw3DSPenPTU5NAOEKjTfW98HaB/https___replicate.delivery_czjl_z4gE33oPjuLPB91f9eO5Np4zaqwm20UYPOZhjpTfXRJVzYmnA_tmppi3by3z7.jpg",
  output_format: "jpg",
  safety_tolerance: 2,
  prompt_upsampling: false
};

const output = await replicate.run("black-forest-labs/flux-depth-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-depth-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-depth-pro",
    input={
        "steps": 50,
        "prompt": "abstract 3D render with the word \"DEPTH\"",
        "guidance": 7,
        "control_image": "https://replicate.delivery/pbxt/M0ivr5QCMktmdUi3t0TFrKtw3DSPenPTU5NAOEKjTfW98HaB/https___replicate.delivery_czjl_z4gE33oPjuLPB91f9eO5Np4zaqwm20UYPOZhjpTfXRJVzYmnA_tmppi3by3z7.jpg",
        "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-depth-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": 50,
      "prompt": "abstract 3D render with the word \\"DEPTH\\"",
      "guidance": 7,
      "control_image": "https://replicate.delivery/pbxt/M0ivr5QCMktmdUi3t0TFrKtw3DSPenPTU5NAOEKjTfW98HaB/https___replicate.delivery_czjl_z4gE33oPjuLPB91f9eO5Np4zaqwm20UYPOZhjpTfXRJVzYmnA_tmppi3by3z7.jpg",
      "output_format": "jpg",
      "safety_tolerance": 2,
      "prompt_upsampling": false
    }
  }' \
  https://api.replicate.com/v1/models/black-forest-labs/flux-depth-pro/predictions

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

Output

Generated in

25.6 seconds

Tweak itReport View full prediction

Examples

View more examples

Pricing

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

$0.05

per output image

or 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 Depth [pro]

Depth-aware image generation that preserves 3D relationships. Transform images while maintaining realistic spatial structure.

FLUX.1 Depth [pro] outperforms proprietary solutions like Midjourney ReTexture in depth-aware tasks. It uses depth maps to maintain precise control during image transformations, letting you edit images while preserving spatial relationships and perspective.

The model excels at: - Architectural visualization - Product placement in scenes - Style transfer with depth preservation - Scene composition with accurate scaling

Offers higher output diversity than other depth-guided models while maintaining spatial accuracy.