Available now

Qwen Image 2.1 Pro: text to image

By Alibaba

Create images with Qwen Image 2.1 Pro from an English or Chinese prompt. Use a negative prompt to exclude competing objects, or export with a transparent background.

Model ID
Maker
Alibaba
Added
October 12, 2026

Model id

Use this in every request
qwen-image-2.1-pro

This model has other modes with their own ids: qwen-image-2.1-pro/edit.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2.1-pro",
  "input": {
    "prompt": "A cut-paper illustration of a yellow raincoat on a peg, with a soft blue shadow and a transparent background."
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "qwen-image-2.1-pro", "quote_id": "QUOTE_ID", "input": {"prompt":"A cut-paper illustration of a yellow raincoat on a peg, with a soft blue shadow and a transparent background."}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for qwen-image-2.1-pro
NameTypeDescription
promptrequiredstring
Describe the desired image in Chinese or English. Alibaba recommends at most 4,500 tokens.
enable_thinkingboolean
Enhance reasoning and image quality; takes longer. Effective only with prompt_extend enabled.

Default: true

ninteger
Choose 1 to 6 output images.

Default: 1

negative_promptstring
Describe content to exclude from the generated image.
prompt_extendboolean
Enable LLM-based prompt rewriting for better results on simple prompts. Default: true.

Default: true

prompt_extend_modestring (enum)
Direct or agent prompt enhancement. Used when prompt_extend is enabled.

Default: direct

One of: direct, agent

seedinteger
Random seed for reproducible generation. Range: 0-2147483647.
sizestring (enum)
Choose a preset output size.

Default: 2048*2048

One of: 512*512, 1024*1024, 2048*2048, 2688*1536, 1536*2688, 2368*1728, 1728*2368

transparent_backgroundboolean
Returns a PNG with a transparent background.

Default: false

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt
"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

  • per image$0.07/ image

The exact charge for your input comes from a quote. How charges settle

API docs

About this model

Overview

The generation form gives you preset canvas sizes and a transparent background option. The edit form takes reference images and follows a separate instruction.

What you can build

  • Transparent graphics for a layout
  • Product compositions from written briefs
  • Edits with details carried over from a reference

Prompting tips

  • Describe the framing and light before adding secondary props.
  • For an edit, name the object to change and the details to retain.
  • For a cutout, turn on Transparent background: prompt rewriting is switched off for that request and the price stays the same.

What to check

Inspect edges, hands, lettering and shadows at full size. For a transparent PNG, view it on a light and a dark background: Pro can keep a soft, semi-transparent shadow under the subject. Keep the prompt, mode, size and seed with the chosen image.

Inputs

  • Prompt (required): Describe the desired image in Chinese or English. Alibaba recommends at most 4,500 tokens.
  • Enable Thinking (optional): Enhance reasoning and image quality; takes longer.
  • Number of Images (optional): Choose 1 to 6 output images.
  • Negative Prompt (optional): Describe content to exclude from the generated image.
  • Prompt Extend (optional): Enable LLM-based prompt rewriting for better results on simple prompts. Default: true.
  • Prompt Enhancement Mode (optional): Direct or agent prompt enhancement. Options: direct, agent.
  • Seed (optional): Random seed for reproducible generation. Range: 0-2147483647.
  • Size (optional): Choose a preset output size. Options: 512*512, 1024*1024, 2048*2048, 2688*1536, 1536*2688, 2368*1728, 1728*2368.
  • Transparent Background (optional): Returns a PNG with a transparent background.

Output and limits

  • Small or dense text in the image can come out misspelled.
  • Hands, crowds and complex poses can show artifacts; generate a few variations and pick the best.
  • Some prompts or outputs can be refused by safety checks.

Price guide

  • per image: $0.07 / image