flux-2-dev/text-to-image
flux-2-dev/text-to-image
FLUX.2 [dev] from Black Forest Labs delivers fast, studio-quality text-to-image generation with enhanced realism, crisper text rendering, and native editing for rapid iteration. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | The positive prompt for the generation. |
| sizeSize | text | 1024*1024 | ≤ 500 chars | The size of the generated media in pixels (width*height). |
| seedSeed | number | — | step 1 | The random seed to use for the generation. -1 means a random seed will be used. |
Output fields
| Field | Type | Description |
|---|---|---|
| images | array<string> |
API
Call this model through one unified REST API. Get a key on the API Keys page.
cURL
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/flux-2-dev/text-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic portrait of a young astronaut standing in a neon-lit greenhouse on Mars, ultra-realistic, detailed face, reflective visor helmet tucked under one arm, lush green plants contrasting with red Martian soil outside the glass dome, soft volumetric lighting, sharp focus, high detail, subtle text label on a nearby equipment case reading \"Ares Botany Lab\"",
"size": "1024*1024",
"seed": -1
}
}'
# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import time, requests
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1) Submit
resp = requests.post(
"https://www.namifusion.com/api/v1/marketplace/run/flux-2-dev/text-to-image",
headers=HEADERS,
json={
"input": {
"prompt": "A cinematic portrait of a young astronaut standing in a neon-lit greenhouse on Mars, ultra-realistic, detailed face, reflective visor helmet tucked under one arm, lush green plants contrasting with red Martian soil outside the glass dome, soft volumetric lighting, sharp focus, high detail, subtle text label on a nearby equipment case reading \"Ares Botany Lab\"",
"size": "1024*1024",
"seed": -1
}
},
)
resp.raise_for_status() # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()
# 2) Poll until a terminal state (completed / failed / cancelled).
# This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
if time.time() > deadline:
raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
time.sleep(3)
poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
poll.raise_for_status()
task = poll.json()
print(task["status"], task.get("output"))JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };
// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/flux-2-dev/text-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cinematic portrait of a young astronaut standing in a neon-lit greenhouse on Mars, ultra-realistic, detailed face, reflective visor helmet tucked under one arm, lush green plants contrasting with red Martian soil outside the glass dome, soft volumetric lighting, sharp focus, high detail, subtle text label on a nearby equipment case reading \"Ares Botany Lab\"",
"size": "1024*1024",
"seed": -1
}
}),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();
// 2) Poll until a terminal state (completed / failed / cancelled).
// This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
await new Promise((r) => setTimeout(r, 3000));
const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
task = await poll.json();
}
console.log(task.status, task.output);Documentation
flux-2-dev/text-to-image
flux-2-dev/text-to-image
FLUX.2 [dev] from Black Forest Labs delivers fast, studio-quality text-to-image generation with enhanced realism, crisper text rendering, and native editing for rapid iteration. Ready-to-use REST inference API, best performance, no cold starts, affordable pricing.
Parameters
| Parameter | Type | Required | Default | Limits / description |
|---|---|---|---|---|
prompt | string | Yes | — | max 5000 chars; The positive prompt for the generation. |
size | string | No | "1024*1024" | max 500 chars; The size of the generated media in pixels (width*height). |
seed | integer | No | — | The random seed to use for the generation. -1 means a random seed will be used. |
Pricing
$0.012 per generated image = 1.2 credits. The price is fixed for this endpoint.
WaveSpeed standard list price; USD 1 = 100 credits. Account discounts are separate.
API
curl -X POST https://www.namifusion.com/api/v1/marketplace/run/flux-2-dev/text-to-image \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"prompt": "A cinematic portrait of a young astronaut standing in a neon-lit greenhouse on Mars, ultra-realistic, detailed face, reflective visor helmet tucked under one arm, lush green plants contrasting with red Martian soil outside the glass dome, soft volumetric lighting, sharp focus, high detail, subtle text label on a nearby equipment case reading \"Ares Botany Lab\"",
"size": "1024*1024",
"seed": -1
}
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
-H "Authorization: Bearer $API_KEY"
Submit returns task_uuid. Poll until completed or failed. Successful output: output.images (URL array). This API is asynchronous and returns URLs.
Related models
z-image-spicy/text-to-image
Generate high-quality images from text with custom dimensions from 256 to 1536 pixels, intelligent prompt rewriting, and seed control for creative design and batch generation.
xAI Grok Imagine Image v2.0 Text to Image
xAI Grok Imagine Image V2.0 Text-to-Image generates high-quality images from text prompts, with configurable aspect ratio, resolution, and quality for creative visuals, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Qwen Image 3.0 Pro Text to Image
Qwen Image 3.0 Pro is a professional-grade text-to-image model with superior quality and advanced prompt understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
ai/prefect-pony-xl
Prefect Pony XL delivers high-quality anime-style image generation for character art and illustrations. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2 Text-to-Image
OpenAI's GPT Image 2 Text-to-Image generates high-quality images from natural-language prompts. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2 Edit
OpenAI's GPT Image 2 Edit enables image editing from natural-language instructions with one or more reference images. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
OpenAI GPT Image 2.5 Sunburst Text-to-Image
High-fidelity image generation for detailed compositions and demanding production work, with up to 4K output.
OpenAI GPT Image 2.5 Flare Text-to-Image
Fast, balanced image generation from natural-language prompts, with up to 4K output.