Technical Specifications of flux-kontext-max
| Specification | Details |
|---|---|
| Model ID | flux-kontext-max |
| Provider / model family | Black Forest Labs FLUX.1 Kontext [max] |
| Primary modality | Image generation and image editing from text and image inputs |
| Core use case | In-context image generation, local edits, full-scene transformations, and text-based image manipulation |
| Quality tier | Premium / maximum-quality variant in the FLUX.1 Kontext family |
| Prompting inputs | Text prompts plus optional input images for editing and transformation workflows |
| Output resolution | Fixed at 1 megapixel with flexible aspect ratios |
| Pricing reference | 8 credits per image, listed as $0.08 per image by Black Forest Labs |
| Concurrency note | Black Forest Labs help documentation lists flux-kontext-max at 6 active tasks, lower than the default account concurrency of 24 |
What is flux-kontext-max?
flux-kontext-max is CometAPI’s platform identifier for Black Forest Labs’ FLUX.1 Kontext [max], a premium image model designed for both text-to-image generation and image editing within a single system. Rather than treating generation and editing as separate tools, the Kontext family is built for in-context workflows where users can provide text instructions, optionally include an image, and then refine, modify, or restyle the result across multiple turns.
The [max] variant is positioned as the highest-quality option in the FLUX.1 Kontext lineup. Black Forest Labs describes it as its premium model with maximum performance, improved prompt adherence, stronger typography generation, and premium consistency for editing, while still supporting fast iterative workflows.
In practice, flux-kontext-max is aimed at teams that need more than basic image synthesis. It is useful for brand-consistent visuals, character-preserving edits, localized changes to existing images, stylization, and text replacement inside scenes such as signs, labels, or UI-like visual elements.
Main features of flux-kontext-max
- Unified generation and editing: Supports both creating images from prompts and editing existing images in the same model workflow, which simplifies application design for creative tools and production pipelines.
- Maximum-quality Kontext tier: The
[max]variant is the premium FLUX.1 Kontext offering, positioned for best output quality, stronger prompt adherence, and higher-end editing consistency. - Character consistency: Designed to preserve identity and recognizable visual traits across multiple scenes and iterative edits, which is valuable for storytelling, marketing assets, and multi-image campaigns.
- Local precision editing: Can modify specific parts of an image while preserving the surrounding composition, enabling targeted object swaps, scene adjustments, or selective clean-up.
- In-context scene transformation: Lets developers transform elements of an existing image while keeping their relationship to the broader scene coherent, rather than regenerating the whole image blindly.
- Typography and text editing strengths: Black Forest Labs highlights improved typography generation, and its help documentation explicitly lists text editing and replacement in signs and labels as a key capability.
- Flexible aspect ratios at fixed 1MP output: Outputs are generated at a fixed 1-megapixel resolution, with flexibility in aspect ratio selection for different product surfaces and creative formats.
- Predictable per-image pricing: Black Forest Labs lists the model at 8 credits or $0.08 per image, making cost estimation straightforward for batch generation and editing workflows.
How to access and integrate flux-kontext-max
Step 1: Sign Up for API Key
To get started, create an account on CometAPI and generate your API key from the dashboard. After that, store the key securely as an environment variable so your application can authenticate requests to the API.
Step 2: Send Requests to flux-kontext-max API
Once you have an API key, send requests to CometAPI’s OpenAI-compatible endpoint and set the model field to flux-kontext-max.
curl --request POST \
--url https://api.cometapi.com/v1/images/generations \
--header "Authorization: Bearer $COMETAPI_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "flux-kontext-max",
"prompt": "Create a cinematic product-style image of a smartwatch on a reflective black surface with dramatic studio lighting"
}'
You can also integrate it using the OpenAI SDK format:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.COMETAPI_API_KEY,
baseURL: "https://api.cometapi.com/v1"
});
const result = await client.images.generate({
model: "flux-kontext-max",
prompt: "Create a cinematic product-style image of a smartwatch on a reflective black surface with dramatic studio lighting"
});
console.log(result);
Step 3: Retrieve and Verify Results
After submission, parse the API response and retrieve the generated image result returned by the platform. You should then verify output quality, prompt adherence, and any requested edits or typography details before using the result in production workflows. For high-volume usage, also account for provider-side concurrency behavior; Black Forest Labs documents a 6-active-task limit for flux-kontext-max.