Black Forest Labs' premium multimodal flow transformer with greatly improved prompt adherence and typography generation for in-context image generation and editing without compromise on speed
Details
flux.1-kontext-max
Starting from
Prices shown are in USD
See all providersProviders & Pricing (4)
FLUX.1 Kontext [max] is available from 4 providers, with per-image pricing starting at $0.08 through fal.ai.
All modes
fal/flux.1-kontext-max
fal/flux.1-kontext-max-edit
fireworks/flux.1-kontext-max
replicate/flux.1-kontext-max
flux-kontext-max API OpenAI-compatible
Integrate FLUX.1 Kontext [max] via the Lumenfall API to perform high-speed text-to-image generation and complex image editing through a single OpenAI-compatible endpoint.
https://api.lumenfall.ai/openai/v1
flux.1-kontext-max
Code Examples
Text to Image
/v1/images/generationscurl -X POST \
https://api.lumenfall.ai/openai/v1/images/generations \
-H "Authorization: Bearer $LUMENFALL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux.1-kontext-max",
"prompt": "",
"size": "1024x1024"
}'
# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'YOUR_API_KEY',
baseURL: 'https://api.lumenfall.ai/openai/v1'
});
const response = await client.images.generate({
model: 'flux.1-kontext-max',
prompt: '',
size: '1024x1024'
});
// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);
from openai import OpenAI
client = OpenAI(
api_key="YOUR_API_KEY",
base_url="https://api.lumenfall.ai/openai/v1"
)
response = client.images.generate(
model="flux.1-kontext-max",
prompt="",
size="1024x1024"
)
# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)
Image Edit
/v1/images/editsParameter Reference
Core Parameters
| Parameter | Type | Description | Modes |
|---|---|---|---|
prompt
|
string | Required. Edit instruction for the image |
T2I
Edit
|
seed
|
integer | Random seed for reproducibility |
T2I
Edit
|
Size & Layout
| Parameter | Type | Description | Modes |
|---|---|---|---|
size
|
string |
Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9")
WxH determines both shape and scale (aspect_ratio and resolution are ignored when size is provided). W:H format is equivalent to aspect_ratio.
|
T2I
Edit
|
aspect_ratio
|
string |
Aspect ratio of the output image (e.g. "16:9", "1:1")
Controls shape independently of scale. Use with resolution to control both. If size is also provided, size takes precedence. Any ratio is accepted and mapped to the nearest supported value.
|
T2I
Edit
|
resolution
|
string |
Output resolution tier (e.g. "1K", "4K")
auto
1K
Controls scale independently of shape. Higher tiers produce larger images and cost more. If size is also provided, size takes precedence for scale. Any tier is accepted and mapped to the nearest supported value.
|
T2I
Edit
|
| Output |
size
|
aspect_ratio
+
resolution
|
|
|---|---|---|---|
| Flexible | |||
| Auto | "auto" |
— | Model chooses optimal dimensions |
1K 13 sizes
| Output |
size
|
aspect_ratio
+
resolution
|
|
|---|---|---|---|
| 1183 × 887 | "1183x887" |
or |
"4:3"
+
"1K"
|
| 916 × 1145 | "916x1145" |
or |
"4:5"
+
"1K"
|
| 1145 × 916 | "1145x916" |
or |
"5:4"
+
"1K"
|
| 1024 × 1024 | "1024x1024" |
or |
"1:1"
+
"1K"
|
| 887 × 1182 | "887x1182" |
or |
"3:4"
+
"1K"
|
| 724 × 1448 | "724x1448" |
or |
"1:2"
+
"1K"
|
| 1448 × 724 | "1448x724" |
or |
"2:1"
+
"1K"
|
| 836 × 1254 | "836x1254" |
or |
"2:3"
+
"1K"
|
| 1254 × 836 | "1254x836" |
or |
"3:2"
+
"1K"
|
| 768 × 1365 | "768x1365" |
or |
"9:16"
+
"1K"
|
| 1365 × 768 | "1365x768" |
or |
"16:9"
+
"1K"
|
| 670 × 1564 | "670x1564" |
or |
"9:21"
+
"1K"
|
| 1563 × 670 | "1563x670" |
or |
"21:9"
+
"1K"
|
How these parameters work
size
Exact pixel dimensions
"1920x1080"
aspect_ratio
Shape only, default scale
"16:9"
resolution
Scale tier, preserves shape
"1K"
Priority when combined
size is most specific and always wins. aspect_ratio and resolution control shape and scale independently.
How matching works
7:1 on a model with
4:1 and 8:1,
you get 8:1.
0.5K 1K 2K 4K)
or megapixel tiers (0.25 1).
If the exact tier isn't available, you get the nearest one.
Media Inputs
| Parameter | Type | Description | Modes |
|---|---|---|---|
image
|
file |
Required.
Input image(s) to edit
Supports PNG, JPEG, WebP.
|
T2I
Edit
|
Output & Format
| Parameter | Type | Description | Modes |
|---|---|---|---|
response_format
|
string |
How to return the image
url
b64_json
Default:
"url" |
T2I
Edit
|
output_format
|
string |
Output image format
png
jpeg
gif
webp
avif
Gateway converts to requested format if provider doesn't support it natively.
|
T2I
Edit
|
output_compression
|
integer | Compression level for lossy formats (JPEG, WebP, AVIF) |
T2I
Edit
|
n
|
integer |
Number of images to generate
Default:
1Gateway generates multiple images in parallel even if provider only supports 1.
|
T2I
Edit
|
Additional Parameters
| Parameter | Type | Description | Modes |
|---|---|---|---|
cfg_scale
|
number | Classifier-free guidance scale — higher values stick more closely to the prompt |
T2I
Edit
|
enhance_prompt
fal
|
boolean | Whether to enhance the prompt for better results. |
T2I
Edit
|
prompt_upsampling
replicate
|
boolean | Automatic prompt improvement |
T2I
Edit
|
safety_tolerance
|
string |
The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.
1
2
3
4
5
6
|
T2I
Edit
|
sync_mode
fal
|
boolean | If `True`, the media will be returned as a data URI and the output data won't be available in the request history. |
T2I
Edit
|
Parameter Normalization
How we handle parameters across different providers
Not every provider speaks the same language. When you send a parameter, we handle it in one of four ways depending on what the model supports:
| Behavior | What happens | Example |
|---|---|---|
passthrough |
Sent as-is to the provider | style, quality |
renamed |
Same value, mapped to the field name the provider expects | prompt |
converted |
Transformed to the provider's native format | size |
emulated |
Works even if the provider has no concept of it | n, response_format |
Parameters we don't recognize pass straight through to the upstream API, so provider-specific options still work.
Gallery
View all 4 imagesFLUX.1 Kontext [max] FAQ
How much does FLUX.1 Kontext [max] cost?
FLUX.1 Kontext [max] starts at $0.08 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.
How do I use FLUX.1 Kontext [max] via API?
You can use FLUX.1 Kontext [max] through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "flux.1-kontext-max". Code examples are available in Python, JavaScript, and cURL.
Which providers offer FLUX.1 Kontext [max]?
FLUX.1 Kontext [max] is available through fal.ai, Fireworks AI, and Replicate on Lumenfall. Lumenfall automatically routes requests to the best available provider.
What is the maximum resolution for FLUX.1 Kontext [max]?
FLUX.1 Kontext [max] supports images up to 2048x2048 resolution.
Overview
FLUX.1 Kontext [max] is a premium multimodal flow transformer model developed by Black Forest Labs, designed for high-fidelity text-to-image generation and complex image editing. As part of the Kontext family, it distinguishes itself by offering native support for in-context learning, allowing for precise control over character consistency and scene composition. The model is specifically engineered to bridge the gap between prompt adherence and hardware efficiency, maintaining fast inference speeds despite its high parameter count.
Strengths
- Typography and Text Rendering: The model excels at generating legible, accurately spelled text within images across various fonts and surfaces, minimizing the common “hallucinations” found in earlier diffusion models.
- Prompt Adherence: It demonstrates a high degree of fidelity to complex, multi-subject prompts, accurately translating descriptive spatial relationships and specific color palettes into the final output.
- In-Context Editing: The model is optimized for image-to-image and editing tasks where maintaining the identity of a specific character or style is paramount, reducing the need for extensive fine-tuning.
- Architectural Efficiency: While positioned as a “premium” model, the underlying flow transformer architecture allows for rapid generation cycles compared to other models of similar scale, making it viable for interactive applications.
Limitations
- Hardware Requirements: Due to its “max” configuration, local deployment requires significant VRAM, though this is mitigated when using hosted API providers.
- Stylistic Defaults: Like many flow-based models, it may default to a highly polished or “digital” aesthetic unless specifically prompted for photographic grain or traditional artistic mediums.
- Complexity Overhead: For simple prompts without text or specific character requirements, the model’s specialized logic may provide diminishing returns compared to faster, more lightweight versions in the FLUX family.
Technical Background
FLUX.1 Kontext [max] utilizes a flow matching transformer architecture, which improves upon traditional diffusion by learning a direct path between noise and the target data distribution. This approach allows for more efficient sampling and better handling of high-resolution details. The “Kontext” variant includes specific architectural adjustments to handle multi-modal inputs, enabling the model to process both text instructions and reference images within the same latent space to ensure visual consistency.
Best For
This model is best suited for professional graphic design workflows, marketing asset generation, and any application requiring precise branding like logos or posters with embedded text. It is highly effective for creators who need to generate a series of images featuring a consistent character or setting. FLUX.1 Kontext [max] is available for experimentation and production use through Lumenfall’s unified API and playground, allowing developers to integrate its advanced typography and editing capabilities into their own applications.
Try FLUX.1 Kontext [max] in Playground
Generate images with custom prompts — no API key needed.