Image

FLUX.1 Kontext

FLUX.1 Kontext is a context-aware image model family for editing and text-to-image generation, with Pro and Max variants, predictable per-image pricing, and asynchronous task processing.

Context-Aware EditingText to ImageFixed Per-Image Pricing

Get API Key API Docs

Service Highlights

Official Discounts
Pay-as-you-go
Fast & Low Latency

Input

Model

Reference Image

Prompt

Aspect Ratio

Output Format

Seed (optional)

Prompt Upsampling

Content Moderation

Safety Tolerance2

Output

Image link valid for 72 hours

FLUX.1 Kontext API Pricing

Transparent pricing with no hidden fees. Pay only for what you use.

Variant	GoldCurrent price	Platinum	Diamond	Official	Your savings
`flux-kontext-pro`	0.32Credits(~$0.032)/pic	0.304Credits(~$0.0304)/pic	0.288Credits(~$0.0288)/pic	0.4Credits(~$0.04)/pic	20%
`flux-kontext-max`	0.64Credits(~$0.064)/pic	0.608Credits(~$0.0608)/pic	0.576Credits(~$0.0576)/pic	0.8Credits(~$0.08)/pic	20%

* Actual costs are subject to final output.

FLUX.1 Kontext API Features

Editing-first capabilities with predictable controls and one asynchronous workflow

Context-Aware Image Editing

Use natural-language instructions to change a background, object, color, or visual treatment while the model considers the supplied image context.

Up to 4 Reference Images

Supply as many as four public image URLs for composition and identity cues. Multi-reference input is an experimental capability.

9 Aspect Ratios

Choose 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 21:9, or 9:21 with the size field.

Format and Safety Controls

Choose PNG, JPEG, or WebP output and set safety_tolerance from 0 to 6.

Unified Asynchronous API

Submit with POST /v1/images/generations, then poll GET /v1/tasks/{task_id} until the task completes or fails.

Fixed Per-Image Billing

Each request returns one image at a fixed model price regardless of aspect ratio or reference count. Failed tasks are refunded automatically.

Pro and Max Options

Choose flux-kontext-pro for faster, lower-cost everyday work, or flux-kontext-max when output quality takes priority over speed and budget.

Prompt Enhancement and Repeatable Seeds

Enable prompt_upsampling to expand instructions, or reuse a fixed seed with the same inputs to help reproduce a result.

Where FLUX.1 Kontext Fits

Use a reference when visual context matters, or omit it for text-to-image generation

Products, Backgrounds & Objects

Create product variants, replace scenes, or modify selected objects through concise editing instructions.

Character & Style Continuity

Use an existing image as context to help carry character traits or visual style across new edits; results can vary by prompt and source image.

Experimental Multi-Reference Fusion

Combine cues from up to four images for compositions such as placing a subject into another scene or blending visual references.

Text-to-Image Generation

Send a prompt without image_urls to generate a new image with either Kontext variant.

Campaign and Social Assets

Edit a core visual into campaign or social-media variations, then select a supported aspect ratio for each placement.

Creative Concept Iteration

Start from an existing image, refine individual elements through text instructions, and explore controlled visual directions across iterations.

Start Using FLUX.1 Kontext

Create an account, authenticate, then submit and poll one unified image task

Create an account and add funds

→

Generate an API key

Create a key in the dashboard and send it as a Bearer token in the Authorization header.

→

Submit and poll the task

POST the request to /v1/images/generations, read data[0].task_id, and poll /v1/tasks/{task_id} until completed or failed.

Get API Key

FLUX.1 Kontext FAQ

Model choice, inputs, controls, billing, and task behavior

What is FLUX.1 Kontext?

FLUX.1 Kontext is Black Forest Labs' context-aware image model family. It is designed primarily for image editing from text instructions and can also generate images from text alone.

What is the difference between Pro and Max?

flux-kontext-pro is the faster, lower-cost option, measured at about 6 seconds for one request. flux-kontext-max targets higher output quality and was measured at about 9 seconds. See this page's pricing details for current prices.

How is Kontext priced?

Pro and Max are each priced using their own original price and actual discount; see this page's live pricing details. Each request generates one image, with no surcharge for aspect ratio or reference-image count. Check the task result for the recorded charge.

How many reference images can I send?

You can pass up to four URLs in image_urls. The output and all reference images must stay within 9MP in total. Multiple references are experimental, and every URL must be publicly accessible.

Can I request an exact image size?

Kontext outputs approximately 1MP, and resolution has no effect. width and height are rejected. Use size with one of the nine supported ratios or a WIDTHxHEIGHT pixel string; pixel strings are converted to the nearest supported ratio. Actual 16:9 and 9:16 outputs may differ from the requested ratio by about 4%.

Which formats and seed controls are available?

Use output_format to select png, jpeg, or webp. seed is optional and random by default; reusing a fixed seed with the same inputs can help reproduce a result.

Can Max rewrite my prompt?

It may. In measured calls, flux-kontext-max expanded the prompt even when prompt_upsampling was not explicitly enabled. Treat prompt rewriting as possible and review outputs when wording must remain strict.

How do asynchronous tasks, refunds, and public URLs work?

Submit a generation request and poll the returned task_id until completed or failed. Failed tasks are refunded automatically. Reference URLs must be publicly reachable; hosts that block data-center traffic can cause fetching to fail, so use a reliable public URL.

How much does the FLUX.1 Kontext API cost?

The Black Forest Labs FLUX.1 Kontext API is billed per generated image. The pricing table on this page lists every specification, and the prices shown are Gold member rates (20% off). Platinum and Diamond members save even more, up to 28%, and you only pay for successful requests.

How do I get a FLUX.1 Kontext API key?

Sign up for APIMart, open the API Keys page in your dashboard, and create a key. The same key works for the Black Forest Labs FLUX.1 Kontext API and every other model on the platform, with pay-as-you-go billing and no subscription.

How do I use the FLUX.1 Kontext API, and where are the docs?

Send your APIMart API key as a Bearer token and POST the request to /v1/images/generations with model set to flux-kontext-pro or flux-kontext-max, plus your prompt and optional image_urls. Read data[0].task_id from the response and poll /v1/tasks/{task_id} until the task is completed or failed. Full parameters and code examples for the Flux Kontext API are in the APIMart docs (docs.apimart.ai).

Is the FLUX.1 Kontext API free?

No. The FLUX.1 Kontext API has no free quota on APIMart. It is pay-as-you-go and billed per generated image, failed tasks are refunded automatically, and Gold members get 20% off, with Platinum and Diamond members saving up to 28%. See this page's live pricing table for current Pro and Max prices.

Which Flux API models are available on APIMart?

APIMart offers two Black Forest Labs model families through one Flux API. FLUX.1 Kontext (flux-kontext-pro and flux-kontext-max) focuses on context-aware image editing, while FLUX.2 (flux-2-pro, flux-2-max and flux-2-flex) covers generation and editing with up to 8 reference images. Both use POST /v1/images/generations and the same API key.

How can I contact support for help?

You can reach us via the live chat in the bottom-right corner, email us at [email protected], or join our Discord community. Our team will get back to you as soon as possible.

Related Models

Explore more models in the same category.

View All Models →