Qwen-Image-2.0
Qwen-Image-2.0 is an advanced image generation and editing model from Alibaba that produces high-quality images at native 2K resolution and renders professional-grade text within visuals. It unifies text-to-image and image-to-image editing into a single model with strong semantic understanding and adheres to detailed prompt instructions. The model excels at generating images that include complex textual content, infographics, posters, and layout-driven visuals.
API Options
Platform-level options for task execution and delivery.
-
taskType
string required value: imageInference -
Identifier for the type of task being performed
-
taskUUID
string required UUID v4 -
UUID v4 identifier for tracking tasks and matching async responses. Must be unique per task.
-
outputType
string default: URL -
Image output type.
Allowed values 3 values
-
outputFormat
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.
**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 3 values
-
outputQuality
integer min: 20 max: 99 default: 95 -
Compression quality of the output. Higher values preserve quality but increase file size.
-
webhookURL
string URI -
Specifies a webhook URL where JSON responses will be sent 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 PLATFORM
- Webhooks
-
deliveryMethod
string default: sync -
Determines how the API delivers task results.
Allowed values 2 values
- Returns complete results directly in the API response.
- Returns an immediate acknowledgment with the task UUID. Poll for results using getResponse.
Learn more 1 resource
- Task Polling PLATFORM
-
uploadEndpoint
string 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.
// 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.jpgThe content data will be sent as the request body to the specified URL when generation is complete.
-
safety
object -
Content safety checking configuration for image generation.
Properties 2 properties
-
safety»checkContentcheckContent
boolean default: false -
Enable or disable content safety checking. When enabled, defaults to
fastmode.
-
safety»modemode
string default: none -
Safety checking mode for image generation.
Allowed values 2 values
- Disables checking.
- Performs a single check.
-
-
ttl
integer min: 60 -
Time-to-live (TTL) in seconds for generated content. Only applies when
outputTypeisURL.
-
includeCost
boolean default: false -
Include task cost in the response.
-
numberResults
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.
inputs object.-
inputs»referenceImagesreferenceImages
array of strings min items: 1max items: 3 -
List of reference images (UUID, URL, Data URI, or Base64).
Generation Parameters
Core parameters for controlling the generated content.
-
model
string required value: alibaba:qwen-image@2.0 -
Identifier of the model to use for generation.
Learn more 3 resources
-
positivePrompt
string required min: 2 max: 2000 -
Text prompt describing elements to include in the generated output.
Learn more 2 resources
-
negativePrompt
string min: 2 max: 500 -
Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).
Learn more 1 resource
-
width
integer step: 1 -
Width of the generated media in pixels.
Learn more 2 resources
-
height
integer step: 1 -
Height of the generated media in pixels.
Learn more 2 resources
Provider Settings
Parameters specific to this model provider. These must be nested inside the providerSettings.alibaba object.
providerSettings.alibaba object.-
providerSettings»alibaba»promptExtendpromptExtend
boolean default: true -
Enable LLM-based prompt rewriting to expand and clarify inputs. Affects reproducibility.
Retro-Futurist Transit Infographic Poster
{
"taskType": "imageInference",
"taskUUID": "9e78d851-1036-4cfa-afe7-23f9565306e7",
"model": "alibaba:qwen-image@2.0",
"positivePrompt": "A beautifully designed retro-futurist public transit infographic poster for the floating city of Aurelia, combining Swiss grid precision with 1970s space-age graphic design. Vertical poster composition with strong hierarchy, bold shapes, clean iconography, elegant color blocking in teal, saffron, cream, midnight blue, and coral. Include highly legible English text integrated into the design with professional typography. Main headline at top: \"AURELIA SKYLINE TRANSIT\". Subtitle beneath: \"Orbit Trams • Canal Ferries • Solar Funiculars\". Add a centered route map with color-coded lines and labeled stops: \"Sunport\", \"Glass Market\", \"North Docks\", \"Moss Library\", \"Crescent Plaza\", \"Cloud Garden\", \"Observatory\", \"South Gate\". Add a fare box reading: \"Day Pass 8 Credits\" and \"Children Under 6 Ride Free\". Add a timetable panel titled \"First Departures\" with rows: \"Tram A 05:40\", \"Ferry C 05:55\", \"Funicular L 06:10\". Add a small footer slogan: \"Move Lightly Through the Future\". Include stylized illustrations of sleek aerial trams, layered terraces, canals, and tiny commuters. Extremely polished poster layout, razor-sharp text rendering, balanced whitespace, museum-quality print aesthetic, subtle paper texture, high detail, visually coherent and realistic as a premium editorial infographic.",
"negativePrompt": "blurry text, misspelled words, low contrast, cluttered layout, distorted map, warped typography, extra panels, watermark, logo, photo-real human faces",
"width": 1536,
"height": 2048,
"providerSettings": {
"alibaba": {
"promptExtend": false
}
}
}{
"taskType": "imageInference",
"taskUUID": "9e78d851-1036-4cfa-afe7-23f9565306e7",
"imageUUID": "6149be29-0250-45fd-b6e7-2148b65ec96a",
"imageURL": "https://im.runware.ai/image/os/a08d21/ws/4/ii/6149be29-0250-45fd-b6e7-2148b65ec96a.jpg",
"seed": 935710734,
"cost": 0.035
}Bilingual Festival Poster
{
"taskType": "imageInference",
"taskUUID": "a9843a8d-c7c1-4377-92e6-76ae6d6b4670",
"model": "alibaba:qwen-image@2.0",
"positivePrompt": "Design a premium vertical cultural festival poster for a contemporary night market event, with elegant professional graphic design, cinematic lighting, and highly legible embedded text. Main headline at the top in large gold letters: 'LANTERN NIGHTS'. Subtitle directly below in clean white text: 'Shanghai Riverfront Arts Festival'. Add a red circular badge near the upper right that says 'OCT 18–20'. In the center, show a vibrant evening street scene with glowing lanterns, food stalls, stylish visitors, paper decorations, and reflections on wet stone pavement. Include a modern stage area in the background with subtle light beams and a river skyline beyond. At the bottom, add a neat information block with the following lines exactly: 'Live Music | Street Food | Design Market' and beneath it '7 PM – 11 PM | North Bund Wharf'. Add a small bilingual footer line: '欢迎光临 Welcome'. Style: luxury editorial poster, sophisticated grid layout, balanced negative space, sharp typography, rich reds and golds, crisp details, premium print-ready composition.",
"negativePrompt": "blurry text, misspelled words, distorted letters, low contrast, cluttered layout, extra limbs, warped faces, watermark, logo artifacts, cropped headline",
"width": 1536,
"height": 2048,
"providerSettings": {
"alibaba": {
"promptExtend": true
}
}
}{
"taskType": "imageInference",
"taskUUID": "a9843a8d-c7c1-4377-92e6-76ae6d6b4670",
"imageUUID": "29372b24-f0e9-4ab9-bc27-bb0f1cd6c7cd",
"imageURL": "https://im.runware.ai/image/os/a11d13/ws/4/ii/29372b24-f0e9-4ab9-bc27-bb0f1cd6c7cd.jpg",
"seed": 215944985,
"cost": 0.035
}Typographic Festival Poster
{
"taskType": "imageInference",
"taskUUID": "eba86a12-a42c-4720-8e05-92f5350b5e57",
"model": "alibaba:qwen-image@2.0",
"positivePrompt": "Design a premium vertical music festival poster with exceptional typography and clean editorial layout. Theme: neon desert synthwave festival at night. Large headline at the top reading exactly: 'LUMINA SOUND FEST 2027'. Subheadline beneath: 'Mojave Arts District • April 18–20'. Add a featured lineup section with readable artist names: 'Astra Nova', 'Glass Horizon', 'Velvet Circuit', 'Echo Bloom'. Add a small ticket box reading: 'Tickets On Sale Now'. Add a footer line reading: 'www.luminasoundfest.com'. Visual style: bold Swiss-grid poster design fused with cinematic synthwave aesthetics, glowing magenta and cyan lighting, subtle desert silhouettes, chrome gradients, crisp vector shapes, layered geometric frames, atmospheric stars, high contrast, refined spacing, professional kerning, immaculate alignment, sharp legible text, premium branding, elegant negative space, print-ready composition.",
"negativePrompt": "misspelled text, gibberish, blurry typography, warped letters, low contrast, cluttered layout, extra limbs, people, watermark, logo artifacts, distorted perspective",
"width": 1440,
"height": 1920,
"providerSettings": {
"alibaba": {
"promptExtend": true
}
}
}{
"taskType": "imageInference",
"taskUUID": "eba86a12-a42c-4720-8e05-92f5350b5e57",
"imageUUID": "6ac32fbd-eb82-43f6-99af-15996aa8974c",
"imageURL": "https://im.runware.ai/image/os/a11d13/ws/3/ii/6ac32fbd-eb82-43f6-99af-15996aa8974c.jpg",
"seed": 1582357229,
"cost": 0.035
}