# 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

## Model Identifiers

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

## Dates


## Tags

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

## Available Providers

### Replicate

- Config Key: replicate/flux.1-kontext-max
- Provider Model ID: black-forest-labs/flux-kontext-max
- Pricing:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.08}]
  - source_url: https://replicate.com/black-forest-labs/flux-kontext-max
  - effective_at: 2025-12-30

### Fireworks AI

- Config Key: fireworks/flux.1-kontext-max
- Provider Model ID: accounts/fireworks/models/flux-kontext-max
- Pricing:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.08}]
  - source_url: 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:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.08}]
  - source_url: https://fal.ai/models/fal-ai/flux-pro/kontext/max/text-to-image
  - effective_at: 2025-12-28


## Image Gallery

4 images available for this model.
- Curated examples: 4
  - "A wide, cinematic medium shot of a high-end, modern architectural studio at sunset. In the center of the frame, a sle..."
  - "Cinematic wide shot of a master watchmaker's workbench, shallow depth of field, an intricate open-heart mechanical po..."
  - "A hyper-realistic close-up of a weathered leather mountaineering backpack resting against a jagged rock in the Dolomi..."
  - "A cozy indie bookstore storefront with a large glass window. On the glass, elegant gold leaf typography reads "STORY ..."

## 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 (Generation)

#### 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": "A serene mountain landscape at sunset",
    "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: 'A serene mountain landscape at sunset',
  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="A serene mountain landscape at sunset",
    size="1024x1024"
)

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

### Image Editing

#### 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 Replicate, Fireworks AI, and fal.ai 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