# FLUX.1 Kontext [pro]

> Black Forest Labs' 12-billion parameter multimodal flow transformer for in-context image generation and editing with character consistency, typography handling, and commercial-ready quality

## Quick Reference

- Model ID: flux.1-kontext-pro
- 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-pro
- Aliases: flux-kontext-pro

## Dates


## Tags

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

## Available Providers

### Replicate

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

### Fireworks AI

- Config Key: fireworks/flux.1-kontext-pro
- Provider Model ID: accounts/fireworks/models/flux-kontext-pro
- Pricing:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.04}]
  - source_url: https://fireworks.ai/pricing

### fal.ai

- Config Key: fal/flux.1-kontext-pro
- Provider Model ID: fal-ai/flux-pro/kontext/text-to-image
- Pricing:
  - source: official
  - currency: USD
  - components: [{"type" => "output", "metric" => "image", "unit_price" => 0.04}]
  - source_url: https://fal.ai/models/fal-ai/flux-pro/kontext
  - effective_at: 2025-12-28


## Image Gallery

4 images available for this model.
- Curated examples: 4
  - "A wide, cinematic shot of a sophisticated high-end design studio at golden hour. On a dark oak desk sits a premium, m..."
  - "A hyper-realistic close-up of a weathered leather workbench in a master shoemaker's atelier. Scatterings of brass tac..."
  - "A hyper-realistic close-up portrait of an elderly artisan watchmaker at work in a sun-drenched, dusty atelier. He is ..."
  - "A sun-drenched outdoor bakery stall with a chalkboard sign that reads "FRESH SOURDOUGH" in elegant hand-lettered curs..."

## Example Prompt

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

A sun-drenched outdoor bakery stall with a chalkboard sign that reads "FRESH SOURDOUGH" in elegant hand-lettered cursive. A baker in a linen apron holds a warm loaf, while a calm capybara sits quietly by the wooden legs of the table.

## 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-pro",
    "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-pro',
  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-pro",
    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-pro" \
  -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-pro',
  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-pro",
    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 [pro] is a 12-billion parameter multimodal flow transformer developed by Black Forest Labs, designed specifically for in-context image generation and editing. It extends the capabilities of the standard FLUX.1 architecture by allowing users to provide image inputs as references to maintain character consistency and stylization across frames. This model is engineered to balance high-fidelity visual output with complex instruction following, making it a professional-grade tool for coherent visual storytelling.

## Strengths
*   **Contextual Character Consistency:** Excels at maintaining the identity, features, and attire of a subject across multiple generated images by utilizing image-to-image reference capabilities.
*   **Typography and Text Rendering:** Demonstrates high precision in rendering complex text strings and layouts, significantly reducing the "gibberish" artifacts common in earlier diffusion models.
*   **In-Context Editing:** Capable of performing precise edits on existing images while preserving the original composition, lighting, and style.
*   **High Parameter Density:** The 12B parameter architecture allows for a nuanced understanding of long, descriptive prompts, resulting in imagery that closely adheres to specific spatial and stylistic instructions.
*   **Commercial-Ready Output:** Produces 1MP+ resolution images with realistic textures, accurate human anatomy, and professional-grade lighting suitable for production environments.

## Limitations
*   **Computational Demand:** Due to its 12-billion parameter count, inference is more resource-intensive and slower compared to "schnell" or "dev" variants of the FLUX family.
*   **Prompt Sensitivity:** To achieve the highest levels of character consistency, users often need to provide high-quality, clear reference images; low-resolution or cluttered references can degrade the output quality.
*   **Higher Latency:** Not optimized for real-time applications, as the multimodal flow transformer architecture prioritizes output depth over generation speed.

## Technical Background
FLUX.1 Kontext [pro] is built on a multimodal flow transformer architecture, a design choice that facilitates better alignment between text prompts and visual data compared to standard U-Net architectures. It utilizes flow matching, a training technique that simplifies the generative process by learning a direct path between noise and the target image distribution. This 12B parameter model was trained to process both text tokens and image patches simultaneously, allowing the "context" (reference images) to directly influence the generation process at the latent level.

## Best For
This model is ideal for storyboarding, character design for gaming or film, and brand-consistent marketing campaigns where a single character or product must appear in various environments. It is a strong choice for graphic design tasks that require embedded, legible text within a scene. FLUX.1 Kontext [pro] is available through Lumenfall’s unified API and playground, allowing developers to integrate high-consistency image generation into their workflows with a single integration.

## Frequently Asked Questions

### How much does FLUX.1 Kontext [pro] cost?

FLUX.1 Kontext [pro] starts at $0.04 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use FLUX.1 Kontext [pro] via API?

You can use FLUX.1 Kontext [pro] through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "flux.1-kontext-pro". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer FLUX.1 Kontext [pro]?

FLUX.1 Kontext [pro] 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 [pro]?

FLUX.1 Kontext [pro] supports images up to 2048x2048 resolution.

## Links

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