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
widthandheightfor 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.widthandheightoverrideresolutionandaspect_ratio - Same size as input image: with
resolution: "match_input", an edit is the same size as the first reference image, up to 4MP. Ifaspect_ratioor 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_ratioatauto, 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
Latest Black Forest Labs API changes
FLUX 3 Image Klein released, a 5.6B open-weights model from $0.008 per image
FLUX 3 Image released, with bounding boxes in prompts and up to 4K output
FLUX 3 video API adds qhd (2K) and uhd (4K) resolutions, from $0.40/s
Automatic credit recharge added, with a threshold and target balance
FLUX Video Upscale released, upscaling clips up to 4K at 1.5×–3×