Skip to content
Back to feed

October 22, 2026 · Black Forest Labs

FLUX 3 Image adds exact width and height and match_input resolution for edits

POST /v1/flux-3-image has two new size options: width and height, and resolution: "match_input" for edits. Edits with one reference image are also more accurate.

Key Features

  • Exact size: send width and height for any size from 256px per side up to 16.8MP (4k), at aspect ratios up to 8:1. With reference images, the limit is 4MP. width and height override resolution and aspect_ratio
  • Same size as input image: with resolution: "match_input", an edit is the same size as the first reference image, up to 4MP. If aspect_ratio or your prompt sets an aspect ratio, the output uses it at a standard size
  • Better edits: edits with one reference image follow the instruction more closely, especially whole-image changes such as weather, relighting, color grading, and restoration, plus text edits and camera moves. No request changes needed
  • No cropping: with aspect_ratio at auto, edits with one reference image use the whole image
  • Backward compatible: requests without the new fields work as before and return 1k

Pricing

Prices are unchanged. Custom and match_input sizes are billed at the smallest resolution with at least as many pixels. Anything above 2k (about 4MP) is billed as 4k.

Endpoint

FLUX 3 Image API reference

Latest Black Forest Labs API changes

All Black Forest Labs API changes