Flux Kontext Max Edit API

blackforestlabs/flux-kontext-max
image_urls · size · output_format

Flux Kontext Max Edit transforms images using complex multi-attribute prompts with extreme facial preservation and typography reconstruction. It maintains global composition and lighting while executing radical creative edits.

Get API Key
Input
Required0/2000
Required
Optional
Optional
OutputIdle

Generated images will appear here

Estimated cost: 16 credits · $0.080

16 credits ($0.080) per generation.

Continue using

Examples

max-edit-01-output.png

Move this exact same musician, still seated on the same wooden chair and playing the same cello, from the practice room to the middle of a vast frozen lake at blue hour. Keep his face, curly black hair, round tortoiseshell glasses, closed eyes, moss-green cable-knit sweater with rolled sleeves, charcoal trousers, brown boots, bow position and the honey-brown cello with its worn varnish identical. The new setting: smooth dark ice with white cracks and a light dusting of snow around the chair, snow-covered pine forest and mountains on the far shore, a deep blue twilight sky with a thin pink glow on the horizon and the first stars. A small warm light from a lantern on the ice beside the chair lights his face and the cello, while the rest of the scene is cool blue. His breath is faintly visible in the cold air. Remove the practice room completely.

max-edit-02-output.jpg

Transform this photograph into a traditional leaded stained-glass window. Keep the exact composition: the four turf-roofed houses with white fronts and red doors, the stone wall, the gravel path, the waterfall on the basalt cliff, the sheep and the cloudy sky, all in the same positions. Render every shape as pieces of colored cathedral glass separated by thick dark lead came lines, with deep emerald and moss greens for the grass roofs and meadow, cobalt and pale blue glass for the sky and waterfall, ruby red for the doors, and milky white glass for the house fronts and sheep. Show light shining through the glass with subtle bubbles, streaks and uneven thickness, and a thin dark iron frame around the whole window.

max-edit-03-output.jpg

Restore and colorize this old photograph. Remove all dust specks, scratches and the diagonal crease, and repair the torn corner so the scene continues naturally. Recover sharp detail and natural contrast. Colorize realistically: vivid young green rice seedlings, muddy brown-green water reflecting a pale blue sky, warm natural skin tones, faded indigo and red traditional woven clothing, grey stone terrace walls with green moss, lush green mountainside and soft white mist on the peaks. Keep the three farmers' faces, poses, hands, positions and the composition exactly the same as the original.

Flux Kontext Max Edit

Flux Kontext Max Edit is the flagship in-context editing model created by Black Forest Labs. Built with an expanded flow-matching transformer, it eliminates identity drift across multifaceted instructions. Without manual masks, creators can perform stylistic transfers, wardrobe restyling, and pixel-precise commercial text replacement while preserving core facial geometry and lighting.

Why Choose Flux Kontext Max Edit API?

  • Complex Multi-Attribute Instruction HandlingExecute multifaceted prompts altering garments, colors, environmental backgrounds, and hand-held objects simultaneously without cross-concept interference.

  • Benchmark Facial and Character PreservationRetains identical facial bone structure, skin complexion, and distinct identity markers through extensive wardrobe changes and dramatic angle variations.

  • Deep Artistic Style and Medium TransformationConverts photorealistic stills into museum-grade oil paintings, expressive watercolors, or pencil sketches while preserving baseline composition.

  • Pixel-Level Packaging and Typography ReconstructionSubstitutes intricate brand logos, curved bottle typography, and vintage editorial signage with extreme alignment to surface geometry.

Parameters

ParameterRequirementDescription
promptRequired

Describe the requested image changes using 1–2,000 characters, including at least one non-whitespace character.

image_urlsRequired

Provide exactly 1 publicly accessible HTTP(S) image URL as the source image. Enter a URL or upload an image.

sizeOptional

Output aspect ratio. Defaults to 1:1.

Default1:14:33:416:99:1621:99:21
output_formatOptional

Output image file format: png or jpg.

pngjpg

How to Use

  1. Supply Reference Image and Detailed DirectivesUpload a high-quality HTTP(S) image URL and draft comprehensive instructions detailing the desired transformations along with explicitly preserved anatomical or compositional features.

  2. Configure Target Aspect Ratio and FormatChoose from 7 standard aspect ratios (defaulting to 1:1, or 16:9, 9:16, 21:9) and select png or jpg output format.

  3. Submit Request and Collect AssetsCall the API endpoint to receive a task_id, monitor generation progress via polling or webhook callback, and utilize the resulting URL for downstream iterative workflows.

Pricing

Each generation costs 16 credits ($0.080) and returns one edited flagship-grade image.

UsageRateDetails
Flagship edit16 credits/generation · $0.080/generationApplies to every size aspect ratio and output_format option

Best Use Cases

  • Theatrical Worldbuilding and Costume IterationTransform contemporary actor headshots into period armor, fantasy garments, or futuristic tactical gear while ensuring facial biometric recognition remains constant.

  • Global Brand Packaging and Typography OverhaulUpdate product copy on embossed glass bottles, luxury cosmetic jars, and curved cans matching physical reflections and lighting gradients.

  • Fine Art Style TransmutationConvert commercial portraiture into classical oil masterworks with thick brushwork, authentic canvas texture, and Renaissance chiaroscuro lighting.

Pro Tips

  • Layered facial preservation clauses: When commanding radical costume transformations, reinforce identity anchors, e.g., Replace the business suit with ornate medieval plate armor while keeping the exact facial structure, eyes, and expression.
  • Describe artistic medium textures: For style shifts, detail tactile physical materials, e.g., Transform to an impressionist oil painting with visible palette knife strokes and canvas weave, maintaining original lighting and pose.
  • Quote text with perspective cues: For curved or reflective packaging typography, specify alignment, e.g., Replace 'PARIS' with 'TOKYO' on the curved perfume glass bottle, matching the metallic embossed typography.

Notes

  • Input configuration: This endpoint requires exactly 1 publicly accessible HTTP(S) image URL in image_urls; for text-to-image creation without reference imagery, use Flux Kontext Max Text to Image.
  • Prompt character bounds: Editing instructions must range from 1 to 2,000 characters after trimming leading and trailing white space.
  • Reliable billing policy: Standard generations are billed at 16 credits ($0.080); requests encountering unexpected server issues are fully and automatically refunded.

Related Models

Flux Kontext Max Edit API Frequently Asked Questions

What is the Flux Kontext Max Edit API?

Flux Kontext Max Edit is Black Forest Labs' flagship model for high-complexity instruction-based image editing. It transforms source images using detailed conversational prompts, offering superior multi-attribute instruction following, maximum character identity retention, and fine-grained artistic style transfer. Built on an advanced multimodal flow-matching architecture, it applies profound creative overhauls while rigorously holding the source image's skeletal anatomy, perspective, and natural illumination. You can call it programmatically or try it from the playground above.

How does Flux Kontext Max Edit handle compound editing instructions?

Flux Kontext Max Edit is engineered specifically for complex prompts. It cleanly isolates multiple simultaneous edit tasks—such as altering clothing style, updating background sceneries, and adjusting facial expressions—executing each directive faithfully without attribute cross-contamination.

Can Flux Kontext Max Edit preserve facial identity during drastic style shifts?

Yes. Even when converting realistic photographs into classical oil paintings, pencil drawings, or pop art illustrations, its deep context feature extractor locks facial bone structures and distinctive personal features to preserve recognizable subject identity.

How do I update packaging typography with Flux Kontext Max Edit?

Enclose the original and desired text in single or double quotes, such as Replace 'OLD BRAND' with 'NEW LABEL' on the glass bottle, and describe the lettering style. The model automatically conforms the new text to physical reflections, curves, and ambient shadows.

What is the generation cost for Flux Kontext Max Edit?

Each completed edit costs 16 credits ($0.080). This transparent pricing applies across all 7 supported aspect ratios and formats. Pre-submission balance checks protect against failures, and interrupted tasks are automatically refunded.

Does Flux Kontext Max Edit accept multiple reference images?

The current endpoint contract is optimized for single-image instruction editing and requires exactly 1 source image URL. For workflows needing simultaneous fusion of multiple distinct reference images, consider exploring FLUX.2 Flex.

Why is Flux Kontext Max Edit recommended for IP character continuity?

Maintaining IP character consistency across varying scenes demands strict avoidance of facial drift. Max Edit offers the highest identity locking capability in the lineup, accurately re-clothing and re-posing characters across serial storyboards while keeping signature traits intact.