Introduction
FLUX.2 Dev Text to image is Black Forest Labs' FLUX.2 [dev], a 32-billion-parameter open-weights model released on 25 November 2025, generating an image from a written prompt. It renders legible text inside the picture, follows hex colour codes, and returns about one megapixel at 1k or up to 2048 pixels on the long side at 2k, in nine aspect ratios. No filter is applied to the prompt or the result.
Choose a mode by starting material
| What you have | Mode |
|---|---|
| a written brief | FLUX.2 Dev Text to image |
| one to three images to change or combine | FLUX.2 Dev Image Edit |
Key features & highlights
Text that comes back spelled
Short quoted text on signs, neon and labels rendered correctly in our tests: a "CLOSED" sign on a shop door and a "VACANCY" neon sign were both spelled as written.
Hex colour control
Write a code such as #FF4F8B or #3AA7FF next to the light or object you describe. It is a strong hint, so it suits mood and lighting more than exact brand matching.
No filter, with the model's own limits
Nothing is reviewed or refused. In our tests the model delivered the Mild, Moderate, Strong and Maximum levels in every run, but the Very strong level came back toned down, so it is not the model for that level.
Request parameters
| Parameter | Required | Description |
|---|---|---|
prompt | Yes | Up to 5,000 characters. Describe subject, clothing, setting, light and camera look in full sentences. at least 1 characters · at most 5000 characters |
aspect_ratio | No | Nine shapes from 21:9 to 9:21; 1:1 is the default. At 1k they are about one megapixel, for example 1344 x 768 at 16:9. |
resolution | No | 1k (default) is about one megapixel; 2k reaches 2048 pixels on the long side. Both tiers cost the same. |
seed | No | A whole number from 0 to 2,147,483,647. Keep it fixed while you change one part of the prompt, so the results are easy to compare. |
Pricing
Billed per image: 1k and 2k cost the same, and the aspect ratio does not change the price. Failed requests are not charged.
| Specification | Price |
|---|---|
| $0.0116 / image |
| $0.0116 / image |
Use cases
Portraits and lifestyle stills
Film-style photographs of one or two people in a believable setting, for mood boards, covers and character references.
Signs, posters and labels
Scenes where a few words must be readable, such as shop windows, neon signs, packaging and posters.
Platforms without moderation
For services whose users expect no moderation on the prompt, with everything from Mild to Maximum in range apart from the Very strong level.
Prompt guide & pro tips
Write it like a photo brief
Subject, clothing, place, light and film look, as full sentences. FLUX.2 follows long prompts well.
Quote the words, place the sign
Put the exact text in quotation marks and say where it sits. Keep it to a few words; long paragraphs can still contain errors.
Name the light and its colour
"Warm #E9A23B tungsten lamps" or "pink neon washing the room in #FF4F8B" gives the scene a clear colour direction.
Render at 2k for the final
Try ideas at 1k, then render the one you like at 2k with the same seed and compare. The price is the same at both tiers.
Say what the people wear
If you want a particular outfit, describe it. In our tests the model followed what the prompt said about clothing.
API quick start
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "black-forest-labs/flux-2-dev/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k",
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
See the API reference for authentication, the complete schema, polling, and error handling.
























