FLUX.2 Max Guide: Hosted Image Editing and Grounded Scenes

FLUX.2 Max is Black Forest Labs' hosted image-generation and editing model, with support for reference images and web-grounded generation. You access it through BFL's Playground or API; no open weights are provided for Max. 1, 2

What are the key facts about FLUX.2 Max?

What can FLUX.2 Max edit and generate with web context?

BFL positions Max for demanding edits and final images, with examples involving product consistency, character continuity, surface changes, and scene composition. Treat these as documented capabilities to evaluate on your own material. 1

Grounding search is a distinct feature of Max. BFL describes using web information to generate scenes involving current events, changing weather, or other time-sensitive context. 1, 2

Try a scene with a specific place and date, then review the depicted facts before approving it. This review step is editorial advice; grounding should not be mistaken for proof that an image is correct.

Reference editing offers a separate kind of control. Supply images that show the product or character you want to retain, then describe the new setting and the role of each input. BFL documents this method for FLUX.2. 5

For example, use a product reference for the object and a room reference for the environment. Write a brief that explicitly preserves the product's shape while allowing changes to its placement and lighting.

Decide what “consistent” means before generating. For a teapot, it might mean handle geometry, lid shape, spout length, and glaze color. Those requirements give a reviewer something specific to inspect.

What limits and prices apply to FLUX.2 Max?

Max's model size is not published in the cited product documentation. Do not infer a parameter count from another FLUX.2 variant, and do not plan local GPU capacity for an endpoint that provides hosted access. 1, 3

BFL's overview distinguishes reference limits by access route: Max supports up to eight inputs through the API and ten in the Playground. Use the limit for your actual interface. 4

The Max API accepts up to eight input images, a prompt, an optional seed, output dimensions, and an output format. Its published schema does not expose sampler selection. 3

For a grounded scene, check place names, dates, labels, and the event being depicted against the underlying evidence. Avoid approving an image merely because it appears plausible or includes convincingly rendered text.

Separate creative instructions from factual inputs in your production notes. “Watercolor illustration” is a visual choice; a displayed temperature or event result is a claim that needs its own verification.

BFL lists Max at $0.07 for the first output megapixel, $0.03 for each additional output megapixel, and $0.03 per input megapixel. Rates checked September 5, 2026. 6

BFL rounds image sizes up for billing and counts each reference as one megapixel when several are supplied. Include those input charges when estimating an editing job. 6

How do you use the FLUX.2 Max API?

1. Create a BFL account, add credits, and create an API key following the official quick start. Store the key in BFL_API_KEY for a server-side request. 7

2. Begin with a plain generation to verify access. The example below submits a task to the actual Max endpoint and prints the URL used to check its status. 3
   

import os
import requests

response = requests.post(
    "https://api.bfl.ai/v1/flux-2-max",
    headers={"x-key": os.environ["BFL_API_KEY"]},
    json={
        "prompt": "A blue ceramic teapot on a limestone shelf, soft side light",
        "width": 1024,
        "height": 1024,
    },
    timeout=60,
)
response.raise_for_status()
print(response.json()["polling_url"])

1. Poll the returned URL. Once its status is Ready, retrieve the signed image URL in result.sample; stop and inspect documented failure responses if the job does not complete successfully. 8

2. For editing, add input_image and the additional documented input slots. Use image URLs or the supported encoded-image route described in BFL's editing guide, and explain each reference's purpose in the prompt. 3, 5

3. For a grounded concept, request the relevant real-world context explicitly. BFL's examples describe current information in the prompt; do not invent an undocumented grounding API field. 1, 3

4. Review the output against your original brief. Save the prompt, references, task ID, downloaded result, and approval notes together so that another reviewer can understand how the image was produced.

For product work, compare the generated object with the source at the same apparent size. Mark altered components or lettering and decide whether to revise the prompt, simplify the scene, or select another output.

For a place-based illustration, list which visible details are factual and which are stylized. That distinction helps you decide whether a requested correction belongs in the factual description or in the visual direction.

How does FLUX.2 Max compare with pro and flex?

Evaluate Max when the edit or grounded context justifies its cost. Compare outputs against a written brief rather than treating the vendor's model hierarchy as a substitute for a task-specific trial.

The FLUX.2 family overview explains the wider lineup. The FLUX photography guide helps turn a visual idea into a concrete scene description.

If your images need no changing factual context, include ordinary reference editing in the trial. This lets you assess whether Max's result is useful for your actual work, even when grounding is irrelevant to the request.

Can I download FLUX.2 Max for ComfyUI?

FLUX.2 Max has hosted Playground and API access, with no open weights provided. A ComfyUI workflow that calls its API would run the image model remotely. 1, 3

How many parameters does Max have?

Black Forest Labs does not publish a FLUX.2 Max parameter count in its product page or API reference. Another FLUX.2 checkpoint's size is not a Max specification. 1, 3

Does grounding make generated information reliable?

FLUX.2 Max's grounding feature uses web information for generation. Independently review factual details in the generated scene before publication. 1, 2

Is Max always $0.07 per image?

FLUX.2 Max costs $0.07 for the first output megapixel. Additional output megapixels and editing inputs add charges under BFL's pricing rules. 6

Sources

• FLUX.2 Max official product page
• BFL dated release notes
• Max endpoint and request schema
• BFL model comparison and access overview
• FLUX.2 image-editing guide
• BFL live pricing
• BFL account and API-key setup
• BFL generation and polling guide

Related guides on PromptZone

• Realistic Photos with FLUX
• Best SDXL Models in 2026