Name: FLUX.1 Kontext [max] API
Brand: Black Forest Labs

Overview

Flux.1 Kontext Max Description

Black Forest Labs' FLUX.1 Kontext Max is an experimental AI model for precision image generation and editing. With advanced rectified flow architecture, it delivers maximum performance for professional creative workflows requiring superior quality and consistency.

‍

‍Technical Specification

Performance Benchmarks

FLUX.1 Kontext Max is optimized for maximum fidelity image generation and surgical editing capabilities.

Generation Speed: 10-12 seconds per image
Architecture: Generative flow matching model with sequence concatenation and double stream blocks

API Pricing:
- $0.104 per generation

‍

Performance Metrics

FLUX models (shown in purple) consistently achieve top performance with ELO ratings often exceeding 1100, demonstrating the strong capabilities of the Flux.1 Kontext model family in various image generation and editing benchmarks.

‍

‍

Key Capabilities

FLUX.1 Kontext Max delivers unprecedented precision for complex visual content creation workflows.

Maximum Performance: Enhanced compute allocation for improved prompt adherence and typography generation compared to Pro and Dev variants
Character Consistency: Superior preservation of facial features and object identity across different environments using AuraFace embeddings
Surgical Editing: Localized modifications to specific elements while preserving surrounding image integrity
Typography Control: Exceptional text generation and replacement capabilities with precise font style retention
Iterative Refinement: Step-by-step editing with minimal quality degradation across editing sequences

‍

Optimal Use Cases

Professional Creative Work: High-end marketing materials, brand assets, and commercial photography requiring maximum quality
Long-form Content: Extended narratives, storyboards, and multi-scene presentations with consistent visual elements
Brand Management: Product placement across multiple contexts with perfect integration and lighting adaptation
Typography-Heavy Projects: Marketing assets, signage updates, and text-based visual communications
Character-Driven Storytelling: Maintaining protagonist identity across diverse scenes and environments for narrative consistency

‍

Code Samples

Text-to-Image Code Sample

‍

Text-to-Image Parameters

prompt [str]: The text prompt describing the content, style, or composition of the image to be generated.
num_images [int]: The number of images to generate
seed [int]: The random seed for image generation
aspect_ratio [ 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 ]: The aspect ratio for the image
guidance_scale [1-20]: The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.
safety_tolerance [1-6]: The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.

‍

Image-to-Image Code Sample

‍

Image-to-Image Parameters

prompt [str]: The text prompt describing the content, style, or composition of the image to be generated.
image_url [str | list of str]: One or more image URLs used as visual references. The model merges them into a single image following the prompt instructions.
num_images [int]: Number of image variations to generate. Each image is a different attempt to combine the reference images (from the image_url parameter) according to the prompt.
seed [int]: The random seed for image generation
aspect_ratio [ 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21 ]: The aspect ratio for the image
guidance_scale [1-20]: The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.
safety_tolerance [1-6]: The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive.

‍

Comparison with Other Models

Vs. FLUX.1 Kontext Pro: Higher compute allocation for improved quality, slower generation (10-12s vs 8-10s), optimized for maximum fidelity over speed.
Vs. ByteDance BAGEL: 4x faster generation speed (10-12s vs 40s), superior character consistency and text preservation
Vs. OpenAI GPT-4o Image: Better character preservation and prompt adherence, faster inference (10-12s vs 30s), higher cost

‍

Licensing

Flux.1 Kontext Max is available under a commercial license that allows both commercial and non-commercial usage rights while ensuring compliance with ethical standards.

‍

API Integration

Accessible via AI/ML API. Documentation: available here.

Uptime and performance

Uptime (7d): 100%

Measured on the AI/ML API gateway across live traffic. Figures are medians unless stated. Last updated 2026-10-12.

Use cases

Professional branding, advertising, and editorial visual design
Content creators requiring superior prompt control and rapid, precise edits
Artists and designers for iterative visual prototyping and concept development
Enterprise applications needing consistent output across multiple scenes and steps
Interactive creative platforms, such as playgrounds and cloud APIs for production-scale editing

How to use FLUX.1 Kontext [max] API

Install any OpenAI-compatible SDK, point it at api.aimlapi.com/v1, and set the model to blackforestlabs/flux-kontext-max.

import requests

r = requests.post(
    "https://api.aimlapi.com/v1/images/generations",
    headers={"Authorization": "Bearer " + AIMLAPI_KEY},
    json={
      "model": "blackforestlabs/flux-kontext-max",
      "prompt": "A cat holding a sign that says hello"
    },
)
print(r.json())

const r = await fetch("https://api.aimlapi.com/v1/images/generations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "blackforestlabs/flux-kontext-max",
    "prompt": "A cat holding a sign that says hello"
  }),
});
console.log(await r.json());

curl -X POST https://api.aimlapi.com/v1/images/generations \
  -H "Authorization: Bearer $AIMLAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"blackforestlabs/flux-kontext-max","prompt":"A cat holding a sign that says hello"}'

OpenAI-compatible — swap the base URL and it works with your existing SDK.