Qwen Image 2.1 Pro Text to Image

alibaba/qwen-image-2.1-pro/text-to-image

Generate 1–6 images from a text prompt, with optional prompt expansion and thinking mode.

Examples

Qwen Image 2.1 Pro Text to Image Examples 1

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea—≤ 5000 charsText 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 Imagesnumber11 ~ 6 · step 1Generate 1-6 images per request, billed per successfully generated image
sizeSizetext—≤ 16 charsWidth*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 Extendbooleantrue—Automatically expands and optimizes the prompt. Recommended; most useful for short prompts.
prompt_extend_modePrompt Extend Modeselectdirectdirect | agentdirect: direct prompt enhancement, suitable for most cases; agent: agent-based enhancement with finer rewriting
enable_thinkingThinking Modebooleantrue—Enhances reasoning to improve image quality at the cost of longer generation time. Only takes effect when Prompt Extend is on.
seedSeednumber—0 ~ 2147483647 · step 1For reproducibility, 0-2147483647. Leave empty for random.

Output fields

FieldTypeDescription
imagesarray<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-pro/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait of a young woman standing in a neon-lit rainy street in Shanghai at night, wearing a modern black trench coat and holding a transparent umbrella, realistic skin texture, dramatic reflections on wet pavement, soft rim lighting, detailed background signage, no text in the image, ultra-detailed, high contrast, professional photography style",
    "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-pro/text-to-image",
    headers=HEADERS,
    json={
        "input": {
            "prompt": "A cinematic portrait of a young woman standing in a neon-lit rainy street in Shanghai at night, wearing a modern black trench coat and holding a transparent umbrella, realistic skin texture, dramatic reflections on wet pavement, soft rim lighting, detailed background signage, no text in the image, ultra-detailed, high contrast, professional photography style",
            "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-pro/text-to-image", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "input": {
      "prompt": "A cinematic portrait of a young woman standing in a neon-lit rainy street in Shanghai at night, wearing a modern black trench coat and holding a transparent umbrella, realistic skin texture, dramatic reflections on wet pavement, soft rim lighting, detailed background signage, no text in the image, ultra-detailed, high contrast, professional photography style",
      "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 Pro Text to Image

alibaba/qwen-image-2.1-pro/text-to-image

Generate 1–6 images from a text prompt, with optional prompt expansion and thinking mode.

Parameters

ParameterTypeRequiredDefaultDescription
promptstringtrue—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
nintegerfalse1Generate 1-6 images per request, billed per successfully generated image [1, 6]
sizestringfalse—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_extendbooleanfalsetrueAutomatically expands and optimizes the prompt. Recommended; most useful for short prompts.
prompt_extend_modestringfalse"direct"direct: direct prompt enhancement, suitable for most cases; agent: agent-based enhancement with finer rewriting direct, agent
enable_thinkingbooleanfalsetrueEnhances reasoning to improve image quality at the cost of longer generation time. Only takes effect when Prompt Extend is on.
seedintegerfalse—For reproducibility, 0-2147483647. Leave empty for random. [0, 2.14748e+09]

Pricing

$0.04 per successfully generated image (4 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-pro/text-to-image \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "n": 1,
    "seed": 12345,
    "size": "2048*2048",
    "prompt": "A cinematic portrait of a young woman standing in a neon-lit rainy street in Shanghai at night, wearing a modern black trench coat and holding a transparent umbrella, realistic skin texture, dramatic reflections on wet pavement, soft rim lighting, detailed background signage, no text in the image, ultra-detailed, high contrast, professional photography style",
    "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.

Alibaba official pricing

Related models

z-image-spicy/text-to-image
Text to ImageZ Image Spicy

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.

from $0.014 / per run
xAI Grok Imagine Image v2.0 Text to Image
Text to ImageX Ai

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.

from $0.080 / per run
Qwen Image 3.0 Pro Text to Image
Text to ImageQwen Image 3.0 Pro

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.

from $0.0638 / per run
ai/prefect-pony-xl
Text to ImagePrefect Pony Xl

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.

from $0.015 / per run
OpenAI GPT Image 2 Text-to-Image
Text to ImageOpenAI

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.

from $0.660 / per run
OpenAI GPT Image 2 Edit
Text to ImageOpenAI

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.

from $0.660 / per run
OpenAI GPT Image 2.5 Sunburst Text-to-Image
Text to ImageOpenAI

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.

from $0.220 / per run
OpenAI GPT Image 2.5 Flare Text-to-Image
Text to ImageOpenAI

OpenAI GPT Image 2.5 Flare Text-to-Image

Fast, balanced image generation from natural-language prompts, with up to 4K output.

from $0.220 / per run