Live APIQwen Image

Qwen Image 2.1

qwen-image-2.1

Text-to-image and reference editing at 1K or 2K, with up to 10 images, local masks, and optional transparent backgrounds.

View request Docs

Model overview

Endpoint: /api/v1/images/generations
Credit cost: 4 credits at 1K, 8 at 2K
Typical latency: Async
Input and output: Text, up to 10 images → PNG, WebP, or JPEG

Capabilities

1K and 2K output
Up to 10 reference images
Local mask edits
Transparent PNG or WebP

Request parameters

Parameter	Type	Requirement	Description
model	string	Required	Model identifier. Default: `qwen-image-2.1`
prompt	string	Required	Generation or edit prompt, up to 5000 characters.
image_urls	string[]	Optional	One to ten public image URLs. Supplying images switches the request to image editing.
aspect_ratio	string	Optional	Text-to-image ratios are 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, and 9:16. Image editing also accepts auto. Default: `3:2 for text-to-image, auto for edits`
resolution	1K \| 2K	Optional	Output resolution tier. 2K costs more credits than 1K. Default: `1K`
background	opaque \| transparent	Optional	Transparent output cannot be JPEG, and cannot be combined with a mask. Default: `opaque`
output_format	png \| webp \| jpeg	Optional	Generated file format. Default: `png`
enhance_prompt	boolean	Optional	Expand the prompt before generation. prompt_extend is accepted as an alias. Default: `true`
seed	integer	Optional	Integer from 0 to 2147483647. Default: `0`
mask_url	string	Optional	Public mask URL for a local edit. Requires exactly one reference image and an opaque background.

Request example

curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2.1",
  "prompt": "Editorial poster for a night market, bold headline NIGHT MARKET, gold ink on charcoal paper, wide margins",
  "aspect_ratio": "3:2",
  "resolution": "1K",
  "output_format": "png"
}'

The generation endpoint is asynchronous. Poll GET /api/v1/tasks/ with the same Bearer key.