# FLUX.1 Kontext [max]

> 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

## Quick Reference

- Model ID: flux.1-kontext-max
- Creator: Black Forest Labs
- Status: active
- Family: flux.1-kontext
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Max Resolution: 2048x2048
- Max Input Images: 1
- Input Modalities: text, image
- Output Modalities: image
- Supported Modes: Text to Image, Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/flux.1-kontext-max?schema=true`.

### Core Parameters

- `prompt` (string) — REQUIRED: Edit instruction for the image. Modes: Image Edit, Text to Image
- `seed` (integer): Random seed for reproducibility. Modes: Image Edit, Text to Image

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9"). Modes: Image Edit, Text to Image
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1"). Modes: Image Edit, Text to Image
- `resolution` (string): Output resolution tier (e.g. "1K", "4K"). Values: auto, 1K. Modes: Image Edit, Text to Image

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit. Modes: Image Edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json. Modes: Image Edit, Text to Image
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif. Modes: Image Edit, Text to Image
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF). Modes: Image Edit, Text to Image
- `n` (integer): Number of images to generate. Default: 1. Modes: Image Edit, Text to Image

### Additional Parameters

- `cfg_scale` (number): Classifier-free guidance scale — higher values stick more closely to the prompt. Modes: Image Edit, Text to Image
- `enhance_prompt` (boolean): Whether to enhance the prompt for better results.. Modes: Image Edit, Text to Image. Only available via fal
- `prompt_upsampling` (boolean): Automatic prompt improvement. Modes: Text to Image, Image Edit. Only available via replicate
- `safety_tolerance` (string): The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.. Values: 1, 2, 3, 4, 5, 6. Modes: Image Edit, Text to Image
- `sync_mode` (boolean): If `True`, the media will be returned as a data URI and the output data won't be available in the request history.. Modes: Image Edit, Text to Image. Only available via fal


## Model Identifiers

- Primary Slug: flux.1-kontext-max
- Aliases: flux-kontext-max


## Tags

image-generation, text-to-image, image-editing, typography, character-consistency

## Available Providers

### fal.ai

- Config Key: fal/flux.1-kontext-max-edit
- Provider Model ID: fal-ai/flux-pro/kontext/max
- Pricing: $0.080/image
  - Source: https://fal.ai/models/fal-ai/flux-pro/kontext/max/text-to-image

### Fireworks AI

- Config Key: fireworks/flux.1-kontext-max
- Provider Model ID: accounts/fireworks/models/flux-kontext-max
- Pricing: $0.080/image
  - Source: https://fireworks.ai/pricing

### fal.ai

- Config Key: fal/flux.1-kontext-max
- Provider Model ID: fal-ai/flux-pro/kontext/max/text-to-image
- Pricing: $0.080/image
  - Source: https://fal.ai/models/fal-ai/flux-pro/kontext/max/text-to-image

### Replicate

- Config Key: replicate/flux.1-kontext-max
- Provider Model ID: black-forest-labs/flux-kontext-max
- Pricing: $0.080/image
  - Source: https://replicate.com/black-forest-labs/flux-kontext-max


## Image Gallery

4 images available for this model. Browse all at https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/gallery

### Curated Examples

- [A wide, cinematic medium shot of a high-end, modern architectural studio at sunset. In the center...](https://assets.lumenfall.ai/iwkoKkEwePwzML_53Lk1OmvQusBzeHGp1U96uY3ALTE/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/mam7b21jyslor0le93uh99j8p8mi@jpeg)
- [Cinematic wide shot of a master watchmaker's workbench, shallow depth of field, an intricate open...](https://assets.lumenfall.ai/En80AvLJ66OjMg68nMnJNJ_fv8ytSJkgQU3xxeCcHXI/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/w5zmsu7jmcfrtg99nj0al45tyqva@jpeg)
- [A hyper-realistic close-up of a weathered leather mountaineering backpack resting against a jagge...](https://assets.lumenfall.ai/S3cK3uJZoV2CuodJICnwSHOYXKpBoL4SoEjbKMFQdA4/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/wj2pynzu58j2kxrst9k1elapm0pc@jpeg)
- [A cozy indie bookstore storefront with a large glass window. On the glass, elegant gold leaf typo...](https://assets.lumenfall.ai/LDUQ-bfXn8QJhzncXxo4V-qHTgvGyF0wX4XS4XVFE_4/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/mb6wtdtm72lz35ajou21iemaj833@jpeg)

## Example Prompt

The following prompt was used to generate an example image in our playground:

A cozy indie bookstore storefront with a large glass window. On the glass, elegant gold leaf typography reads "STORY & SOUL". Inside, a woman browses the shelves. A small capybara sits quietly on the sidewalk by the door, wearing a tiny scarf.

## Code Examples

### Text to Image (/v1/images/generations)

#### cURL

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": "..." }] }

#### JavaScript

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);

#### Python

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/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=flux.1-kontext-max" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'flux.1-kontext-max',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="flux.1-kontext-max",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## About

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

## Frequently Asked Questions

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

## Links

- Model Page: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max
- About: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/providers
- API Reference: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/api
- Benchmarks: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/benchmarks
- Use Cases: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/use-cases
- Gallery: https://lumenfall.ai/models/black-forest-labs/flux.1-kontext-max/gallery
- Playground: https://lumenfall.ai/playground?model=flux.1-kontext-max
- API Documentation: https://docs.lumenfall.ai