Black Forest Labs: FLUX.1 Kontext [pro]

FLUX.1 Kontext [pro] handles both text and reference images as inputs, seamlessly enabling targeted, local edits and complex transformations of entire scenes.

Compare models

flux-kontext-pro

AvailableBlack Forest LabsImageSync / Async

Price: From $0.04
Context: 4K
Max output: 4K
Modalities: Image

About FLUX.1 Kontext [pro]

FLUX.1 Kontext [pro] is Black Forest Labs' standard tier of the Kontext family, taking a text instruction and reference images to make targeted local edits or transform whole scenes. It accepts up to four input images and aspect ratios from 21:9 to 9:21. The maker lists Kontext as legacy, pointing new editing work to FLUX.2 [pro] or [flex].

Where it works well

It reads both text and reference images, so local edits keep untouched parts of the picture in place.
Complex transformations of an entire scene are possible as well as small changes.
Prompt upsampling can be switched on for more creative interpretation of short instructions.

When to choose another model

Black Forest Labs now classes it as legacy and recommends FLUX.2 [pro] or [flex] for new work.
Multi-image input is experimental, so results from several references can vary.
Kontext [max] is the higher tier when typography and prompt adherence matter more.

Getting started

Create API key
Create a key in Console, then use it with every model on the platform.

Send your first request

Copy the example for your language and run it against the endpoint.

Image editingText to imageTokenLab endpoint

POST/v1/images/edits

curl -X POST "https://api.tokenlab.sh/v1/images/edits" \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "flux-kontext-pro",
  "prompt": "A minimalist product photo of matte black headphones on a soft blue background.",
  "image_url": "https://example.com/source.png"
}'

Parameters

Image editing

Parameter	Values and limits	Default	Notes
`async`	Not provided	Not provided	Not provided
`image`	Not provided	Not provided	This public operation accepts source images. The maximum total source-image count is not yet verified.
`operation`	Not provided	Not provided	Not provided
`prompt`	Not provided	Not provided	Not provided
`resolution`	Not provided	Not provided	Model-specific resolution values and the default are not yet verified for this public operation.

Text to image

Parameter	Values and limits	Default	Notes
`async`	Not provided	Not provided	Not provided
`image`	Not provided	Not provided	Text-to-image does not accept source images. Do not send this field for that operation. Use one of this model's declared image operations for source-image requests.
`operation`	Not provided	Not provided	Not provided
`prompt`	Not provided	Not provided	Not provided
`resolution`	Not provided	Not provided	Model-specific resolution values and the default are not yet verified for this public operation.

Use `/v1/images/edits` for image-edit and `/v1/images/generations` for text-to-image.

Pricing

The Verified price applies to Verified, which costs less on most models. The Official price is the model maker's published price and applies to the more reliable Official route. Auto bills the route that completes the request.

Image editing / Text to image

per request

Official price: $0.04
Verified price: —
Discount: —

	Official priceper request	Verified priceper request	Discount
Image editing / Text to image	$0.04	—	—

Usage & activity

Success rate is the share of requests that completed. Latency is how long a full response takes; P95 means 95% of requests finished within that time.

Usage & availability

Last 24 hours

Requests
Success rate
P95 latency
Total tokens

Model performance

Last updated Nov 1, 2026, 7:59 AM UTC

Metrics appear once privacy and data volume thresholds are met.

Data is based on aggregate user requests, excluding status checks.

Open in Console

Open FLUX.1 Kontext [pro] in Console with a prompt ready to edit or send.

Help me create an image with flux-kontext-pro using image-edit at /v1/images/edits. Show the result, cost, and any limits I should know.

Use cases

Best for

Text to Image

Targeted photo edits
Change one object, colour, or background in a photo without regenerating the rest.
Scene restyling
Transform a whole picture into a different season, time of day, or art style from one instruction.
Reference-based creation
Use a product or character image as context to produce new scenes that keep its look.

Prompt examples

Remove the parked car on the left and fill the space with cobblestones that match the street.

Turn this summer garden photo into a snowy winter scene, keep the bench and path positions.

Make the jacket in this photo dark green leather, leave the face and background alone.

FAQ

What is FLUX.1 Kontext [pro] used for?

Editing and creating images from text plus reference images. It suits targeted local edits and larger scene transformations where the original composition should survive the change.

How does Kontext [pro] compare with Kontext [max]?

Both take the same kinds of input. [max] is the higher tier with improved prompt adherence and typography; [pro] is the standard tier. Choose [max] for text-heavy edits.

Is Kontext [pro] deprecated?

Black Forest Labs calls it a legacy model and suggests FLUX.2 [pro] or [flex] for new image editing tasks. It still works for existing pipelines.

What aspect ratios does Kontext [pro] support?

Anything between 21:9 and 9:21, from ultrawide to tall portrait. Output can be PNG, JPEG, or WebP, with PNG as the default, and a seed makes results repeatable.

How much does FLUX.1 Kontext [pro] cost?

On TokenLab, FLUX.1 Kontext [pro] costs $0.04 per request. The pricing table above shows the full breakdown. Rates depend on the billing unit, specification, and usage. Compare matching conditions in the model's detailed pricing; a single rate does not determine the total cost.

Which endpoint should FLUX.1 Kontext [pro] use?

Use https://api.tokenlab.sh/v1/images/edits for FLUX.1 Kontext [pro]. The request example below shows the matching code shape.

Which operations does FLUX.1 Kontext [pro] support?

FLUX.1 Kontext [pro] supports Image editing, Text to image. Select an operation above to see its endpoint and request example.