FLUX.1 Kontext [max]

AI Image Editing Model

Image $$$ · 8¢

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

2048 x 2048
Max Resolution
Supported Modes
Text to Image Image Edit
Active

Details

Model ID
flux.1-kontext-max
Also known as: flux-kontext-max
Family
flux.1-kontext
Max Input Images
1
Tags
image-generation text-to-image image-editing typography character-consistency
// Get Started

Ready to integrate?

Access flux.1-kontext-max via our unified API.

Create Account
Available at 3 providers

Starting from

$0.080 /image via fal.ai, Fireworks AI, Replicate

Prices shown are in USD

See all providers

Providers & Pricing (4)

FLUX.1 Kontext [max] is available from 4 providers, with per-image pricing starting at $0.08 through fal.ai.

fal.ai
Text to Image
fal/flux.1-kontext-max
Provider Model ID: fal-ai/flux-pro/kontext/max/text-to-image
$0.080 /image
fal.ai
Image Edit
fal/flux.1-kontext-max-edit
Provider Model ID: fal-ai/flux-pro/kontext/max
$0.080 /image
Fireworks AI
Text to Image Image Edit
fireworks/flux.1-kontext-max
Provider Model ID: accounts/fireworks/models/flux-kontext-max
$0.080 /image
Replicate
Text to Image Image Edit
replicate/flux.1-kontext-max
Provider Model ID: black-forest-labs/flux-kontext-max
$0.080 /image

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.

Base URL
https://api.lumenfall.ai/openai/v1
Model
flux.1-kontext-max

Code Examples

Text to Image

/v1/images/generations
curl -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": "..." }] }

Image Edit

/v1/images/edits

Parameter Reference

Required Supported Not available

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 aspect_ratio + resolution aspect_ratio resolution

size is most specific and always wins. aspect_ratio and resolution control shape and scale independently.

How matching works

Shape matching – we pick the closest supported ratio. Ask for 7:1 on a model with 4:1 and 8:1, you get 8:1.
Scale matching – providers use different tier formats: K tiers (0.5K 1K 2K 4K) or megapixel tiers (0.25 1). If the exact tier isn't available, you get the nearest one.
Dimension clamping – if a model has pixel limits, we clamp dimensions to fit and keep the aspect ratio intact.

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: 1
Gateway 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.

FLUX.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.

Open Playground