Launch Sale:50% OFFon yearly plans for a Limited Time Only
FLUX Outpainting: Expand Any Image
Jul 30, 2026

FLUX Outpainting: Expand Any Image

Extend images past their borders with no prompt. The 4MP canvas cap, fast mode geometry limits, the renamed offset fields, and the free demo.

You have a square product shot and you need a 3:1 banner. The usual options are both bad: crop and lose the product, or paste it on a coloured rectangle and call it a design.

Outpainting is the third option — extend the actual scene outward so the composition simply continues. FLUX Outpainting does it without a prompt: you send the image and the target canvas size, and the model works out what belongs there.

Sourcing note: endpoint, canvas limits, fast-mode constraints, field names and error semantics below come from Black Forest Labs' FLUX Outpainting documentation. The demo link is BFL's own. Last verified July 30, 2026.

What this guide solves

The pain point: reformatting one asset for many placements is a manual chore, and prompt-driven "extend this image" attempts in a generation model drift in style and lighting.

The differentiator: the constraints that actually cause failures — the 4MP canvas cap, the extra geometry rules that only apply in fast mode, and a field rename that silently 422s configs copied from older examples.

The basics

POST https://api.bfl.ai/v1/flux-tools/outpainting-v1
x-key: $BFL_API_KEY

Poll the returned polling_url for the result, as with every FLUX endpoint.

You POST the input image (base64) plus target canvas dimensions. No prompt is needed — BFL notes their own example output was produced with no prompt at all, and describes the endpoint as tuned to continue the input image's content, lighting and composition on its own.

The limits that matter

The canvas is capped at 4 MP (width × height). That is the hard ceiling, and BFL adds a softer warning on top: very large canvases or extreme aspect ratios may reduce quality even inside that limit.

So a 3:1 banner at 2048×683 is comfortable. A 5:1 ultrawide at maximum resolution is technically legal and likely to look worse than a slightly smaller one.

Minimum 64 px per side, and both width and height must be present.

The field rename that breaks copied code

BFL's docs are explicit that the endpoint rejects unknown fields, and that the offsets are now:

  • reference_offset_x / reference_offset_y
  • bbox_x1 / bbox_y1 — the older names

If you are getting a 422 with a config that looks correct, check this first. Rejecting unknown fields is good API design, but it turns a rename into a hard failure rather than a silently ignored parameter.

Fast mode has extra rules

BFL documents that fast mode adds geometry constraints beyond the standard ones:

  • Pass a base64 image, not a URL
  • The placed reference must be at least 64 px per side
  • It must stay within an 8:1 aspect ratio

A 422 that only appears in fast mode is almost always one of these three, not your image data.


Need the base image before you extend it? Flux 3 AI generates product visuals, campaign frames and reference shots in the browser, with upscaling for delivery. Open the image generator or see the plans.


What it is actually good for

  • Aspect-ratio conversion — one hero shot becomes a banner, a square, and a vertical story without a reshoot
  • Social reformatting — the same asset across placements with different safe areas
  • Breathing room — a composition that feels cramped gets margin instead of being cropped tighter
  • Banner generation — extending a scene sideways to leave clean space for a headline

That last one is a small trick worth naming: outpaint wider than you need, and you get an area of genuine scene continuation to place type over, rather than a flat colour block.

A note on how it fills

BFL mentions the model was trained on green, blue and magenta fill colours and performs best with those internally — but explicitly adds that no caller action is needed, because the server handles fill colours automatically.

Worth knowing only so you do not go looking for a fill-colour parameter. There isn't one to set.

Error codes

  • 403 Forbidden — API key missing, or your project lacks access to this endpoint. Entitlement, not just authentication.
  • 422 / validation error — check base64 encoding, that width and height are present and at least 64, that their product does not exceed 4 MP, and that you are using the current field names.

Try it before you build

There is a free interactive demo at flux-tools.bfl.ai/outpainting. Run the exact assets you plan to reformat through it — extension quality depends heavily on what is at the edges of your source image, and five minutes in the demo tells you more than any sample gallery.

FAQ

Does FLUX Outpainting need a prompt? No. You send the image and target dimensions; the model extends the scene on its own.

What is the maximum output size? The canvas area is capped at 4 MP.

What is the minimum dimension? 64 px per side.

Why am I getting 422 errors? Check base64 encoding, width/height presence and limits, and that you are using reference_offset_x / reference_offset_y rather than the older bbox_* names.

Why does fast mode fail when normal mode works? Fast mode adds constraints: base64 only, reference at least 64 px per side, within 8:1 aspect ratio.

Can I choose the fill colour? No — the server handles it internally.

Is there a free way to test it? Yes, BFL hosts an interactive demo.

Bottom line

Outpainting is the least fussy of the FLUX Tools — an image, two numbers, no prompt. The failures are all constraint violations rather than quality problems: the 4MP ceiling, the 64 px floor, fast mode's geometry rules, and the renamed offset fields.

Stay inside those and reformatting stops being manual work. If you need the source imagery first, create it in the Flux 3 AI workspace.

Sources

  1. FLUX Outpainting (BFL documentation) — endpoint, no-prompt behaviour, 4MP cap, fast-mode constraints, field names, fill-colour note, error codes, demo
  2. FLUX Outpainting announcement (BFL, May 14, 2026) — release and positioning
  3. FLUX Tools model page — the tool family
  4. FLUX Erase (BFL docs) — the mask-based sibling, for contrast
  5. Image generation quick start (BFL docs) — shared async pattern and signed-URL expiry
  6. Errors reference (BFL docs) — full error semantics
  7. FLUX API integration guide (BFL docs) — production integration guidance
  8. BFL API pricing — how Tools calls are billed
  9. FLUX.2 model page — the generation model for when you need a new image instead
  10. FLUX Deblur (BFL docs) — the other no-prompt restoration tool

Scope note: limits and field names as of July 30, 2026. Flux 3 AI is an independent creator workspace, not affiliated with Black Forest Labs.

Start Creating with the Flux 3 AI Video Generator for Free

Try the Flux 3 AI Video Generator to create an image from a prompt or reference photo, then shape it into a video concept.