FLUX.2 Pro API

Reference images

3

Combine up to three sources, such as a person, a product and a setting, in one edit.

Largest size tier

2K

1k is about one megapixel; 2k reaches 2048 pixels on the long side.

Aspect ratios

9

From 21:9 to 9:21, including square, 4:3 and 3:2.

Colour control

Hex

Write colours as hex codes in the prompt and they are followed closely.

Renders: on screen as written. Softened: generated, but milder than what was written. Refused: rejected. Not tested yet: we have not run that level on that mode.

• Text to image

  A fragrance poster with correct type

  A fragrance advertising poster. A man in his thirties with wet swept-back dark hair and light stubble stands waist-deep in a calm sea at dusk, wearing a white linen shirt fully unbuttoned and soaked through, looking past the camera. Muted teal sky and water in #1B3A4B with a thin band of copper light on the horizon in #C97B4A. Clean minimalist layout: an elegant wide-spaced serif headline at the top reads "SALT & CEDAR", and smaller sans-serif text at the bottom reads "EAU DE PARFUM". Photographic, high-end campaign look, correctly spelled text.

  Why it works. A tall poster at 1k with both lines of type quoted and placed, and two hex codes for the palette. Both lines came back spelled as written and the sea and horizon took the specified tones.

  Try this promptCopy prompt

• Text to image

  Two women, one slow morning

  Two women in their thirties share a slow morning on a narrow wrought-iron balcony above a Lisbon street with tiled facades. One, with long dark curls, wears an ivory satin slip dress with one thin strap slipped off her shoulder and leans on the railing holding a small espresso cup; the other, with a cropped platinum pixie cut, wears an oversized unbuttoned pale-blue linen shirt over a white tank top and rests her chin on her partner's shoulder from behind. Soft early sunlight, warm terracotta rooftops and laundry lines in the background, candid documentary photograph, natural skin texture.

  Why it works. A wide 1k frame that describes each woman by hair, clothing and pose. The result keeps freckles and fine lines, with low sun behind the rooftops.

  Try this promptCopy prompt

• Text to image

  Kitchen dance at 2am

  Candid 35mm film photograph of a woman and a man in their thirties dancing barefoot in a small apartment kitchen at 2am. She wears an oversized white men's dress shirt with rolled sleeves, hair falling loose; he wears grey sweatpants and a fitted white undershirt, one hand on her waist, foreheads almost touching, both laughing. A single warm pendant lamp, the open fridge spilling cool light across the floor, dishes in the sink, a record player on the counter. Soft grain, natural imperfect framing.

  Why it works. Two light sources, a warm lamp and the cold fridge, give the frame its mood. The film grain and loose framing read as a snapshot rather than a studio shot.

  Try this promptCopy prompt

• Image editing

  Person, product and place in one ad

  Create a headphone advertisement. The man from image 1 wears the headphones from image 2 over his ears and stands on the wet rooftop from image 3 at night, eyes closed and smiling, one hand touching an ear cup. Keep his face, hair and cream cardigan exactly as in image 1, and keep the sand-beige and gold design of the headphones exactly as in image 2. The string lights and city skyline glow behind him, reflected in the wet floor. Add a clean white sans-serif headline at the top that reads "HEAR THE CITY".

  Why it works. Three sources, each given a role by number, with the parts that must not change listed. The headline was added in the same step and came out spelled correctly.

  This mode starts from your own image: add it in the playground before you run.

  Try this promptCopy prompt

• Image editing

  Noon street to rainy neon night

  Turn this sunny noon street into the same street on a rainy night: wet pavement reflecting out-of-focus red and teal neon lights, light rain falling, a dark sky. Relight the woman to match, with teal light on one side of her face and warm red light on the other, and raindrops on the shoulders of her blazer. Keep her face, hair, earrings, tan blazer, white blouse and pose exactly the same.

  Why it works. One source, keeping its shape. The setting and the light change completely while the person, outfit and pose are named as fixed. The neon came out mostly red on her face, with the teal in the background.

  This mode starts from your own image: add it in the playground before you run.

  Try this promptCopy prompt

One image starts at $0.03 at 1K and $0.039 at 2K.

The playground shows the exact price for your settings before you run. Failed or timed-out tasks are usually not charged. Some models charge for content refusals as stated on their model page; check those billing terms before submitting.

About FLUX.2 Pro

FLUX.2 [pro] is Black Forest Labs' production model for photoreal portraits, posters with readable text and colours pinned by hex code, with up to three references in an edit. Moderation applies, so it serves campaign, editorial and character work rather than the strongest content levels.