Qwen Image 2.1 Turbo Text to Image
alibaba/qwen-image-2.1-turbo/text-to-image
Generate 1–6 images from a text prompt, with optional prompt expansion and thinking mode.
Examples
Parameters
| Name | Type | Default | Constraints | Description |
|---|---|---|---|---|
| prompt *Prompt | textarea | — | ≤ 5000 chars | Text prompt describing the desired image, supports Chinese and English; up to about 4500 tokens is recommended. Negative prompts are not supported, so state anything to avoid directly in the prompt (e.g. "no text in the image"). Ask for a transparent background, sticker or cutout and the model outputs a PNG with an alpha channel. |
| nNumber of Images | number | 1 | 1 ~ 6 · step 1 | Generate 1-6 images per request, billed per successfully generated image |
| sizeSize | text | — | ≤ 16 chars | Width*height format. Total pixels from 512*512 to 2048*2048, aspect ratio between 1:8 and 8:1. Recommended: 2048*2048 (1:1), 2688*1536 (16:9), 1536*2688 (9:16), 2368*1728 (4:3), 1728*2368 (3:4). Leave empty to let the model auto-select a resolution. |
| prompt_extendPrompt Extend | boolean | true | — | Automatically expands and optimizes the prompt. Recommended; most useful for short prompts. |
| prompt_extend_modePrompt Extend Mode | select | direct | direct | agent | direct: direct prompt enhancement, suitable for most cases; agent: agent-based enhancement with finer rewriting |
| enable_thinkingThinking Mode | boolean | true | — | Enhances reasoning to improve image quality at the cost of longer generation time. Only takes effect when Prompt Extend is on. |
| seedSeed | number | — | 0 ~ 2147483647 · step 1 | For reproducibility, 0-2147483647. Leave empty for random. |
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/alibaba/qwen-image-2.1-turbo/text-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cozy futuristic reading nook inside a glass-walled apartment overlooking a rainy cyberpunk city at dusk, warm ambient lighting, a woman sitting in a curved chair reading a book, shelves with plants and soft blankets, realistic textures, cinematic composition, highly detailed, polished typography on a subtle book cover only, no extra text in the image, no watermark",
"n": 1,
"size": "2048*2048",
"prompt_extend": true,
"prompt_extend_mode": "direct",
"enable_thinking": true,
"seed": 12345
}
}'
# 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/alibaba/qwen-image-2.1-turbo/text-to-image",
headers=HEADERS,
json={
"input": {
"prompt": "A cozy futuristic reading nook inside a glass-walled apartment overlooking a rainy cyberpunk city at dusk, warm ambient lighting, a woman sitting in a curved chair reading a book, shelves with plants and soft blankets, realistic textures, cinematic composition, highly detailed, polished typography on a subtle book cover only, no extra text in the image, no watermark",
"n": 1,
"size": "2048*2048",
"prompt_extend": True,
"prompt_extend_mode": "direct",
"enable_thinking": True,
"seed": 12345
}
},
)
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/alibaba/qwen-image-2.1-turbo/text-to-image", {
method: "POST",
headers: { ...HEADERS, "Content-Type": "application/json" },
body: JSON.stringify({
"input": {
"prompt": "A cozy futuristic reading nook inside a glass-walled apartment overlooking a rainy cyberpunk city at dusk, warm ambient lighting, a woman sitting in a curved chair reading a book, shelves with plants and soft blankets, realistic textures, cinematic composition, highly detailed, polished typography on a subtle book cover only, no extra text in the image, no watermark",
"n": 1,
"size": "2048*2048",
"prompt_extend": true,
"prompt_extend_mode": "direct",
"enable_thinking": true,
"seed": 12345
}
}),
});
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
Qwen Image 2.1 Turbo Text to Image
alibaba/qwen-image-2.1-turbo/text-to-image
Generate 1–6 images from a text prompt, with optional prompt expansion and thinking mode.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | true | — | Text prompt describing the desired image, supports Chinese and English; up to about 4500 tokens is recommended. Negative prompts are not supported, so state anything to avoid directly in the prompt (e.g. "no text in the image"). Ask for a transparent background, sticker or cutout and the model outputs a PNG with an alpha channel.; max 5000 characters |
n | integer | false | 1 | Generate 1-6 images per request, billed per successfully generated image [1, 6] |
size | string | false | — | Widthheight format. Total pixels from 512512 to 20482048, aspect ratio between 1:8 and 8:1. Recommended: 20482048 (1:1), 26881536 (16:9), 15362688 (9:16), 23681728 (4:3), 17282368 (3:4). Leave empty to let the model auto-select a resolution.; max 16 characters |
prompt_extend | boolean | false | true | Automatically expands and optimizes the prompt. Recommended; most useful for short prompts. |
prompt_extend_mode | string | false | "direct" | direct: direct prompt enhancement, suitable for most cases; agent: agent-based enhancement with finer rewriting direct, agent |
enable_thinking | boolean | false | true | Enhances reasoning to improve image quality at the cost of longer generation time. Only takes effect when Prompt Extend is on. |
seed | integer | false | — | For reproducibility, 0-2147483647. Leave empty for random. [0, 2.14748e+09] |
Pricing
$0.016 per successfully generated image (1.6 credits). Precharge = unit price × requested n; settlement uses the actual successful output image count. Input reference images, output size and prompt expansion add no charge. Default n=1.
size uses width*height; total pixels 512²–2048², aspect ratio 1:8–8:1. Omit size for automatic selection. Omit seed for random generation. enable_thinking only applies when prompt_extend=true.
Alibaba International standard USD list prices. USD 1 = 100 credits. Account discounts are applied separately.
API
curl -X POST https://www.namifusion.com/api/v1/marketplace/run/alibaba/qwen-image-2.1-turbo/text-to-image \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"n": 1,
"seed": 12345,
"size": "2048*2048",
"prompt": "A cozy futuristic reading nook inside a glass-walled apartment overlooking a rainy cyberpunk city at dusk, warm ambient lighting, a woman sitting in a curved chair reading a book, shelves with plants and soft blankets, realistic textures, cinematic composition, highly detailed, polished typography on a subtle book cover only, no extra text in the image, no watermark",
"prompt_extend": true,
"enable_thinking": true,
"prompt_extend_mode": "direct"
}
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
-H "Authorization: Bearer $API_KEY"
Poll task_uuid until completed or failed. On success, output.images contains output URL strings.
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.