---
title: Qwen-Image-2.1-Pro | Runware Docs
url: https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro
description: Unified image generation and multi-reference editing with LLM prompt rewriting
---
# Qwen-Image-2.1-Pro

![Qwen-Image-2.1-Pro](https://assets.runware.ai/covers/alibaba-qwen-image-2-1-pro.jpg)

Qwen-Image-2.1-Pro is the Pro tier of Alibaba's Qwen-Image-2.1 family, a unified model for text-to-image generation and prompt-guided image editing. It composes and edits from up to 10 reference images and can rewrite prompts with an LLM before generation, in a direct or agent mode with optional thinking. It outputs from 0.26 to 4.19 megapixels at aspect ratios from 1:8 to 8:1, suited to product imagery, marketing visuals, and multi-image compositions.

- **Status**: live
- **ID**: `alibaba:qwen-image@2.1-pro`
- Try in Playground
- **Creator**: Alibaba
- **Release Date**: September 20, 2026
- **Capabilities**: Text to Image, Image to Image, Edit, Checkpoint, Transparency

## Pricing

$0.075 per run · ~1m 1s per request

**4 example generations**

- [text-to-image](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro/examples#example-airport-falconer-editorial-portrait) · 1536×1024: `$0.075` (~1m 3s)
- [reference-to-image](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro/examples#example-antique-automaton-auction-cleanup) · 1024×1536: `$0.075` (~28s)
- [reference-to-image](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro/examples#example-sheep-shearing-docuseries-poster) · 1024×1536: `$0.075` (~59s)
- [text-to-image](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro/examples#example-abyssal-cable-repair-game-key-art) · 1536×1024: `$0.075` (~1m 10s)

times vary, measured end to end · [How pricing works](https://runware.ai/docs/models-api/pricing)

## Compatibility & Validation

When `inputs.referenceImages` is provided, `settings.promptExtendMode` must be `direct`.

---

When `settings.promptExtend` is `false`, `settings.thinking` cannot be used.

---

`width` and `height` must be used together.

## Request Parameters

**API Options**

Platform-level options for task execution and delivery.

### [taskType](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task being performed.

### [taskUUID](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.

### [outputType](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-outputtype)

- **Type**: `string`
- **Default**: `URL`

Image output type.

**Allowed values**: `URL` `base64Data` `dataURI`

### [outputFormat](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-outputformat)

- **Type**: `string`
- **Default**: `JPG`

Specifies the file format of the generated output. The available values depend on the task type and the specific model's capabilities.

- \`JPG\`: Best for photorealistic images with smaller file sizes (no transparency).
- \`PNG\`: Lossless compression, supports high quality and transparency (alpha channel).
- \`WEBP\`: Modern format providing superior compression and transparency support.

> [!NOTE]
> \*\*Transparency\*\*: If you are using features like background removal or LayerDiffuse that require transparency, you must select a format that supports an alpha channel (e.g., \`PNG\`, \`WEBP\`, \`TIFF\`). \`JPG\` does not support transparency.

**Allowed values**: `JPG` `PNG` `WEBP`

### [outputQuality](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-outputquality)

- **Type**: `integer`
- **Min**: `20`
- **Max**: `99`
- **Default**: `95`

Compression quality of the output. Higher values preserve quality but increase file size.

### [webhookURL](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-webhookurl)

- **Type**: `string`
- **Format**: `uri`

Webhook URL that receives JSON responses via HTTP POST when generation tasks complete. For batch requests with multiple results, each completed item triggers a separate webhook call as it becomes available.

**Learn more** (1 resource):

- [Webhooks](https://runware.ai/docs/models-api/webhooks) (platform)

### [deliveryMethod](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-deliverymethod)

- **Type**: `string`
- **Default**: `sync`

Determines how the API delivers task results.

**Allowed values**:

- `sync` Returns results directly in the API response. Over HTTP, a task still running after 120 seconds continues as an async task and comes back with status 'processing'. Poll for its results using getResponse.
- `async` Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.

**Learn more** (1 resource):

- [Task Polling](https://runware.ai/docs/models-api/task-polling) (platform)

### [uploadEndpoint](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-uploadendpoint)

- **Type**: `string`
- **Format**: `uri`

Specifies a URL where the generated content will be automatically uploaded using the HTTP PUT method. The raw binary data of the media file is sent directly as the request body. For secure uploads to cloud storage, use presigned URLs that include temporary authentication credentials.

**Common use cases:**

- **Cloud storage**: Upload directly to S3 buckets, Google Cloud Storage, or Azure Blob Storage using presigned URLs.
- **CDN integration**: Upload to content delivery networks for immediate distribution.

```text
// S3 presigned URL for secure upload
https://your-bucket.s3.amazonaws.com/generated/content.mp4?X-Amz-Signature=abc123&X-Amz-Expires=3600

// Google Cloud Storage presigned URL
https://storage.googleapis.com/your-bucket/content.jpg?X-Goog-Signature=xyz789

// Custom storage endpoint
https://storage.example.com/uploads/generated-image.jpg
```

The content data will be sent as the request body to the specified URL when generation is complete.

### [safety](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-safety)

- **Path**: `safety.checkContent`
- **Type**: `object (1 property)`

Content safety checking configuration for image generation.

#### [checkContent](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-safety-checkcontent)

- **Path**: `safety.checkContent`
- **Type**: `boolean`

Enable or disable content safety checking. Increases total generation time and adds a small charge on top of the generation cost.

### [ttl](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-ttl)

- **Type**: `integer`
- **Min**: `60`

Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.

### [includeCost](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-includecost)

- **Type**: `boolean`

Include task cost in the response.

### [numberResults](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-numberresults)

- **Type**: `integer`
- **Min**: `1`
- **Max**: `20`
- **Default**: `1`

Number of results to generate. Each result uses a different seed, producing variations of the same parameters.

**Inputs**

Input resources for the task (images, audio, etc). These must be nested inside the \`inputs\` object.

### [referenceImages](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-inputs-referenceimages)

- **Path**: `inputs.referenceImages`
- **Type**: `array of strings`
- **Min items**: `1`
- **Max items**: `10`
- **File size (each)**: `up to 10 MB`

List of reference images (UUID, URL, Data URI, or Base64).

**Core Parameters**

Primary parameters that define the task output.

### [model](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-model)

- **Type**: `string`
- **Required**: true
- **Value**: `alibaba:qwen-image@2.1-pro`

Send `auto` instead of an AIR identifier to have the model router choose the model for this task. The rest of the request is unchanged, every value you send is kept, and only the parameters you leave out are filled in. See [Model Router](https://runware.ai/docs/models-api/model-router).

**Learn more** (3 resources):

- [Text To Image: Model Selection](https://runware.ai/docs/learn/text-to-image#model-selection) (learn)
- [Image Inpainting: Model Specialized Inpainting Models](https://runware.ai/docs/learn/image-inpainting#model-specialized-inpainting-models) (learn)
- [Image Outpainting: Other Critical Parameters](https://runware.ai/docs/learn/image-outpainting#other-critical-parameters) (learn)

### [positivePrompt](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-positiveprompt)

- **Type**: `string`
- **Required**: true
- **Min**: `2`
- **Max**: `3000`

Text prompt describing elements to include in the generated output.

**Learn more** (1 resource):

- [Prompts](https://runware.ai/docs/learn/prompts) (learn)

### [width](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-width)

- **Type**: `integer`
- **Min**: `192`
- **Max**: `4096`

Width of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [height](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-height)

- **Type**: `integer`
- **Min**: `192`
- **Max**: `4096`

Height of the generated media in pixels.

**Learn more** (2 resources):

- [Dimensions](https://runware.ai/docs/learn/dimensions) (learn)
- [Image Outpainting: Dimensions Critical For Outpainting](https://runware.ai/docs/learn/image-outpainting#dimensions-critical-for-outpainting) (learn)

### [seed](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-seed)

- **Type**: `integer`
- **Min**: `0`
- **Max**: `2147483647`

Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.

**Settings**

Technical parameters to fine-tune the inference process. These must be nested inside the \`settings\` object.

### [promptExtend](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-settings-promptextend)

- **Path**: `settings.promptExtend`
- **Type**: `boolean`
- **Default**: `true`

Enable LLM-based prompt rewriting to expand and clarify inputs. Affects reproducibility.

### [promptExtendMode](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-settings-promptextendmode)

- **Path**: `settings.promptExtendMode`
- **Type**: `string`
- **Default**: `direct`

Rewriting strategy for `promptExtend`.

**Allowed values**:

- `direct` Direct prompt expansion.
- `agent` Agent-based rewrite.

### [thinking](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-settings-thinking)

- **Path**: `settings.thinking`
- **Type**: `boolean`

Enables thinking mode for improved quality at the cost of increased generation time.

**Features**

Standalone addons and post-processing features.

### [watermark](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark)

- **Path**: `advancedFeatures.watermark`
- **Type**: `object (6 properties)`

Configuration object for adding watermarks to generated videos. Watermarks can be applied using either text or image content with customizable positioning and appearance. You must provide either `text` or `image` content for the watermark, but not both.

**Text watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "© 2025 Company",
    "displayPosition": "bottom-right",
    "opacity": 0.6,
    "fontColor": "#ffffff",
    "bgColor": "#000000"
  }
}
```

**Image watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "image": "c64351d5-4c59-42f7-95e1-eace013eddab",
    "displayPosition": "top-left",
    "opacity": 0.6
  }
}
```

**Tiled watermark**:

```json
"advancedFeatures": {
  "watermark": {
    "text": "PREVIEW",
    "tiled": true,
    "opacity": 0.4,
    "fontColor": "#cccccc"
  }
}
```

#### [text](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark-text)

- **Path**: `advancedFeatures.watermark.text`
- **Type**: `string`
- **Min**: `2`
- **Max**: `32`

Watermark text.

#### [image](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark-image)

- **Path**: `advancedFeatures.watermark.image`
- **Type**: `string`

Watermark image (UUID, URL, Data URI, or Base64).

#### [displayPosition](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark-displayposition)

- **Path**: `advancedFeatures.watermark.displayPosition`
- **Type**: `string`

Watermark position.

**Allowed values**: `top-left` `top-center` `top-right` `center-left` `center-center` `center-right` `bottom-left` `bottom-center` `bottom-right` `tiled`

#### [opacity](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark-opacity)

- **Path**: `advancedFeatures.watermark.opacity`
- **Type**: `float`
- **Min**: `0.1`
- **Max**: `1`
- **Step**: `0.01`

Watermark opacity.

#### [fontColor](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark-fontcolor)

- **Path**: `advancedFeatures.watermark.fontColor`
- **Type**: `string`

Text color in hex format.

#### [bgColor](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#request-advancedfeatures-watermark-bgcolor)

- **Path**: `advancedFeatures.watermark.bgColor`
- **Type**: `string`

Background color in hex format.

## Response Parameters

### [taskType](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-tasktype)

- **Type**: `string`
- **Required**: true
- **Value**: `imageInference`

Identifier for the type of task this response belongs to.

### [taskUUID](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-taskuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID v4 identifier echoed from the original request, used to match async responses to their tasks.

### [imageUUID](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-imageuuid)

- **Type**: `string`
- **Required**: true
- **Format**: `UUID v4`

UUID of the output image.

### [imageURL](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-imageurl)

- **Type**: `string`
- **Format**: `uri`

URL of the output image.

### [imageBase64Data](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-imagebase64data)

- **Type**: `string`

Base64-encoded image data.

### [imageDataURI](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-imagedatauri)

- **Type**: `string`
- **Format**: `uri`

Data URI of the output image.

### [seed](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-seed)

- **Type**: `integer`

The seed used for generation. If none was provided, shows the randomly generated seed.

### [NSFWContent](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-nsfwcontent)

- **Type**: `boolean`

Flag indicating if NSFW content was detected.

### [cost](https://runware.ai/docs/models/alibaba-qwen-image-2-1-pro#response-cost)

- **Type**: `float`

Task cost in USD. Present when `includeCost` is set to `true` in the request.

## Examples

### text-to-image (text-to-image)

![Airport Falconer Editorial Portrait](https://assets.runware.ai/examples/alibaba-qwen-image-2-1-pro/0f1a4af9-6e10-4ea8-89ca-55f6f82bba5a.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "4d5d4d64-8a22-415c-858d-9f852962328b",
  "model": "alibaba:qwen-image@2.1-pro",
  "positivePrompt": "A cinematic yet naturalistic editorial photograph for a serious weekend magazine feature about airport wildlife control. At blue hour just before sunrise, an experienced female falconer in her late 40s stands on a wet service road beside an active regional airport runway. She occupies the left third of the landscape frame, composed and self-assured, looking toward the runway rather than at the camera. A Harris's hawk perches alertly on her raised leather gauntlet, with accurate plumage, talons, jesses and believable anatomy. Her practical uniform includes a weathered olive field jacket, reflective safety vest, radio, telemetry receiver and utility belt, all unbranded. Fine mist hangs over the tarmac. In the middle distance, amber runway lights recede in precise perspective while a passenger jet taxis softly out of focus; a windsock, low hangars and grassy margins establish the aviation setting. Cool cyan dawn light mixes with warm sodium-orange runway lamps, reflected in shallow puddles. The falconer's face and the hawk's eye are sharply resolved, with authentic skin texture, wind-tousled hair and subtle condensation in the cold air. Shot at eye level with a 35mm documentary lens, restrained depth of field, realistic scale, nuanced dynamic range, sophisticated magazine color grading, gentle film grain. Leave calm atmospheric space across the upper-right sky for editorial layout, but include no typography. Premium environmental portrait, observational rather than posed, credible airport operations, no visible brands or logos.",
  "width": 1536,
  "height": 1024,
  "settings": {
    "promptExtend": true,
    "promptExtendMode": "agent",
    "thinking": true
  }
}
```

---

### text-to-image (text-to-image)

![Abyssal Cable Repair Game Key Art](https://assets.runware.ai/examples/alibaba-qwen-image-2-1-pro/28d357f6-2817-4823-8ade-f3dc05a12840.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "c1d2e3e5-1cef-4204-a016-da84356e3787",
  "model": "alibaba:qwen-image@2.1-pro",
  "positivePrompt": "Premium landscape key art for a cooperative deep-sea engineering adventure game. In the foreground, two commercial saturation divers in bulky white pressure suits with amber helmet lights work together on a ruptured transoceanic communications cable: one kneels beside an open titanium junction housing and operates a precise fiber-splicing tool, while the other braces against the current and guides a thick cable segment into place. Their practical equipment includes tether lines, tool packs, pressure gauges, articulated gloves, and small identification markings. Bright glass fibers glow cyan inside the damaged cable, immediately communicating the repair objective. Midground: a compact industrial maintenance submersible hovers above them, painted safety orange and cream, with manipulator arms, work lamps, scratched hull panels, cable reels, and twin thrusters disturbing clouds of pale sediment. Background: the cable disappears across a vast abyssal plain toward a field of hydrothermal vents and the dark silhouette of a continental trench. A long translucent siphonophore drifts harmlessly through the upper water, accompanied by tiny bioluminescent organisms, adding scale and natural wonder without becoming a monster. Strong triangular composition linking divers, submersible, and cable; low wide camera near the seabed; clear silhouettes and readable cooperative action. Cinematic hand-painted realism inspired by vintage oceanographic expedition posters and high-end contemporary game concept art, with tactile brushwork, believable engineering, atmospheric depth, ultramarine and near-black water contrasted by safety orange, warm amber lamps, and electric cyan fibers. Tense but purposeful mood, rich environmental storytelling, polished commercial key-art finish, no title or typography.",
  "width": 1536,
  "height": 1024,
  "settings": {
    "promptExtend": true,
    "promptExtendMode": "agent",
    "thinking": true
  }
}
```

---

### reference-to-image (reference-to-image)

![Antique Automaton Auction Cleanup](https://assets.runware.ai/examples/alibaba-qwen-image-2-1-pro/a691e2ef-65a6-4703-91a0-d5b590cefb17.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "ec445978-9444-483b-8b7c-d115b1a27fb9",
  "model": "alibaba:qwen-image@2.1-pro",
  "positivePrompt": "Edit the supplied auction intake photograph into a finished museum-quality catalog image. Remove the white nitrile-gloved hand completely and remove the bright blue foam support wedge beneath the automaton. Generatively reconstruct the portions they obscure: continue the oval gilded brass base with matching engraved scrollwork, authentic aged patina, fine scratches, edge profile, contact shadow, and the visible dark walnut tabletop grain. Make the automaton appear naturally freestanding and physically stable. Preserve the exact identity, proportions, position, bird pose, feather colors, miniature foliage, mechanical details, glass dome, camera angle, crop, sage backdrop, walnut table, soft diffused lighting, reflections, depth of field, and all genuine age marks not targeted by the edit. The repaired areas must blend seamlessly with the original photograph and remain historically plausible. Photorealistic professional auction catalog retouching, restrained color, precise material detail, no beautification or redesign.",
  "width": 1024,
  "height": 1536,
  "settings": {
    "promptExtendMode": "direct"
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/b6ff2071-c4c6-4e88-9de5-322c82a1dc53.jpg"
    ]
  }
}
```

---

### reference-to-image (reference-to-image)

![Sheep Shearing Docuseries Poster](https://assets.runware.ai/examples/alibaba-qwen-image-2-1-pro/a8ae9e9c-f43a-445b-85b1-a166af1169ec.jpg)

```json
{
  "taskType": "imageInference",
  "taskUUID": "d0938e50-e7d3-4c53-974f-e5802b9919d0",
  "model": "alibaba:qwen-image@2.1-pro",
  "positivePrompt": "Transform the supplied documentary photograph into a finished 2:3 portrait streaming-series poster while preserving the woman’s recognizable facial identity, age, expression, centered stance, clothing, hand position, electric shears, the sheep beside her, eye-level viewpoint, and essential shearing-shed composition. Reinterpret the photograph as sophisticated screen-printed editorial key art: high-contrast carved textures, selective photographic facial detail, rough ink edges, subtle paper grain, and bold geometric blocks inspired by mid-century agricultural competition posters. Use a distinctive palette of warm uncoated cream, deep oxblood red, charcoal black, and a small accent of pasture green. Keep the woman monumental and credible rather than heroic fantasy; she is a real elite craftsperson at work. Retain recognizable timber pens and hanging equipment as simplified graphic shapes. Add generous negative space above her head for typography. At the top, set the exact title “THE FINAL FLEECE” in large condensed uppercase black lettering, clean, correctly spelled, and highly legible. Directly above it, in small uppercase red type, place the exact line “A THREE-PART DOCUMENTARY”. No other text. Strong visual hierarchy, premium independent documentary tone, tactile analog print finish, dramatic but grounded, polished final poster artwork filling the canvas edge to edge, not a poster mockup and not shown in a frame.",
  "width": 1024,
  "height": 1536,
  "settings": {
    "promptExtendMode": "direct"
  },
  "inputs": {
    "referenceImages": [
      "https://assets.runware.ai/assets/inputs/a4dfe1e3-b887-4443-8a3d-95b579399fda.jpg"
    ]
  }
}
```