Introduction
FLUX.2 [max] Text to image is the top-quality model of Black Forest Labs' FLUX.2 family, released on 16 December 2025, generating images from a written prompt. It is built for photoreal people and light, legible text inside the image and colours set with hex values, at 1k or 2k in nine aspect ratios.
Choose a mode by starting material
| What you have | Mode |
|---|---|
| a written brief | FLUX.2 Max Text to image |
| one to three photos to change or combine | FLUX.2 Max Edit |
Key features
Photoreal people and light
Fabric sheen, skin texture, shallow depth of field and a named lens and light direction come through clearly.
Text and hex colours
Quote each line of type and say where it sits. Our magazine-cover example rendered a masthead, cover lines and an issue line exactly as written, on a background set by a hex value.
Two size tiers, nine shapes
1k is about one megapixel and 2k reaches 2048 pixels on the long side, from square to 21:9 and 9:21.
Request parameters
| Parameter | Required | Description |
|---|---|---|
seed | No | Reuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647 |
prompt | Yes | Describe the subject, setting, light and style in plain sentences. |
resolution | No | Output size. Bigger sizes look sharper and cost more. 1k · 2k · Default: 1k |
aspect_ratio | No | The shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · Default: 1:1 |
Pricing
Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.
| Option | Credits per image | ≈ USD |
|---|---|---|
| resolution 1K | 10.5 | $0.11 |
| resolution 2K | 13.21 | $0.13 |
Each task is rounded up to whole credits, so one run at the lowest tier costs 11 credits per image ($0.11).
For an exact number before you run, send the same body to POST /jobs/quote.
Use cases
Editorial and campaign portraits
Fashion, lifestyle and brand portraits for mood boards, pitch decks and campaign drafts.
Covers, posters and labels
Magazine covers, event posters and packaging where several pieces of text share the frame with an image.
Cinematic stills
Widescreen frames with a described lens, light and grade for storyboards and key art.
Prompt guide & pro tips
Write it like a photo brief
Subject, wardrobe, setting, lens, light direction and grade, as full sentences.
Quote and position all text
Every word that must appear goes in quotes with a position; unquoted words are treated as description.
Give colours as hex values
#0F5C4A for a gown or #4A0E1A for a backdrop is followed more closely than a colour name.
Expect 20 to 90 seconds
Most of our requests finished in that range; 2k and a busy queue take longer.
API quick start
Call the FLUX.2 Max API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
- Send the request. POST /jobs/createTask with model black-forest-labs/flux-2-max/text-to-image and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-max/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "1k"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
FLUX.2 Max API questions
How much does the FLUX.2 Max API cost?
FLUX.2 Max starts at 11 credits ($0.11) per image with Create Image, its cheapest task. Prices by option: 1K 10.5 credits per image, 2K 13.21 credits per image. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.
What is the model name for FLUX.2 Max in the API?
Put black-forest-labs/flux-2-max/text-to-image for Create Image; black-forest-labs/flux-2-max/edit for Edit Image in the model field of POST /jobs/createTask.
What is FLUX.2 [max]?
It is the top-quality model of Black Forest Labs' FLUX.2 family, released on 16 December 2025. It is aimed at photoreal people and light, readable text in the image and edits that combine several references.
Can it write text into images?
Yes. Our magazine-cover example rendered a masthead, a cover line and an issue line, all spelled as written. Quote each line and say where it sits. Hex colour values in the prompt are followed closely.
How many reference images can I use?
One to three. Refer to them in the prompt as image 1, image 2 and image 3 and say what each one contributes. Our bookshop example placed two women from separate portraits into a third photo of a room.
What does auto do in edits?
With auto the result keeps the shape of the first source image at about one megapixel. Choosing a ratio instead lets you pick 1k or 2k.
Does it search the web or take steps and guidance settings?
No. Those controls are not offered here. You get the prompt, aspect ratio, size tier and seed.
What are the limits of the FLUX.2 Max API?
Resolutions: 1K · 2K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +3; Prompt length (characters): 5,000. Requests outside these limits are rejected before anything is charged.
Can I try FLUX.2 Max without writing code?
Yes. The Playground runs FLUX.2 Max on your PopNow credits, needs no API key, and shows the matching code for every run.
All FLUX models
FLUX.2 Pro is cheaper and faster for everyday work. Max is the one for hero portraits and covers.
- FLUX.2 Max APITop-tier FLUX: photoreal light and exact brand colorsFrom 11 credits per image
- FLUX 3 APIVideo with synced sound and a quick draft tierFrom 45 credits for a 5-second clip
- FLUX.2 Klein 9B LoRA APIFast FLUX.2 Klein 9B that loads up to three of your LoRAsFrom 3 credits per image
- FLUX.2 Klein Base 9B LoRA APIUndistilled Klein 9B for varied looks with your LoRAsFrom 4 credits per image
- FLUX.2 Klein 4B LoRA APISmall, quick FLUX.2 Klein 4B with your own LoRAsFrom 3 credits per image
- FLUX.2 Klein Base 4B LoRA APIUndistilled Klein 4B that loads your own LoRAsFrom 3 credits per image
- FLUX.2 Klein 9B APIFast FLUX edits that keep faces and poses intactFrom 2 credits per image
- FLUX.2 Klein 4B APIThe smallest, quickest FLUX for rapid draftsFrom 2 credits per image
- FLUX.2 Dev LoRA APIFLUX.2 Dev images and edits with your own LoRAsFrom 4 credits per image
- FLUX.2 Pro APIPhotoreal images with readable text and hex color controlFrom 5 credits per image
- FLUX.2 Flex APISpells headlines and labels exactly as writtenFrom 9 credits per image
- FLUX.2 Dev APIOpen-weights FLUX that can merge people into one sceneFrom 2 credits per image
- FLUX.1 Krea Dev LoRA APIPhotographic FLUX.1 Krea with your own LoRAsFrom 4 credits per image
- FLUX.1 Dev ControlNet LoRA APIPose, depth or edge control on FLUX.1 with your LoRAsFrom 6 credits per image
- FLUX.1 Fill Dev LoRA APIMasked inpainting on FLUX.1 Fill with your own LoRAsFrom 7 credits per image
- FLUX.1 Dev LoRA APIClassic FLUX.1 Dev with up to three of your LoRAsFrom 3 credits per image
- FLUX.1 Schnell LoRA APIFast FLUX.1 Schnell that loads your own LoRAsFrom 1 credit per image

