Official

black-forest-labs / flux-canny-pro

Professional edge-guided image generation. Control structure and composition using Canny edge detection

Warm

Public
158.7K runs
$0.05 per image
Commercial use
License

Run with an API

Playground API Examples README

Input

prompt

*string

Shift + Return to add a new line

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

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

const input = {
  steps: 28,
  prompt: "a photo of a car on a city street",
  guidance: 25,
  control_image: "https://replicate.delivery/pbxt/M0j11UQhwUWoxUQ9hJCOaALsAHTeoPZcGGtUf6n3BJxtKHul/output-14.webp",
  output_format: "jpg",
  safety_tolerance: 2,
  prompt_upsampling: false
};

const output = await replicate.run("black-forest-labs/flux-canny-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-canny-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-canny-pro",
    input={
        "steps": 28,
        "prompt": "a photo of a car on a city street",
        "guidance": 25,
        "control_image": "https://replicate.delivery/pbxt/M0j11UQhwUWoxUQ9hJCOaALsAHTeoPZcGGtUf6n3BJxtKHul/output-14.webp",
        "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-canny-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": 28,
      "prompt": "a photo of a car on a city street",
      "guidance": 25,
      "control_image": "https://replicate.delivery/pbxt/M0j11UQhwUWoxUQ9hJCOaALsAHTeoPZcGGtUf6n3BJxtKHul/output-14.webp",
      "output_format": "jpg",
      "safety_tolerance": 2,
      "prompt_upsampling": false
    }
  }' \
  https://api.replicate.com/v1/models/black-forest-labs/flux-canny-pro/predictions

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

Output

Generated in

16.0 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.05 / image or 20 images / $1

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

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

Readme

FLUX.1 Canny [pro]

Edge-guided image generation that preserves structure and composition. Perfect for retexturing images or turning sketches into detailed art.

FLUX.1 Canny [pro] leads the field in structural conditioning. It uses Canny edge detection to maintain precise control during image transformations. Feed it an edge map and text prompt to generate images that follow exact structural guidance while adding rich detail.

Particularly effective for: - Converting sketches to finished art - Retexturing while preserving composition - Controlled style transfer - Architectural visualization

License

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