Qwen Image 2.1 API reference

Call Qwen Image 2.1 from your own code with one PopNow API key. Below are the exact model IDs to send, every input field the model accepts, what each request costs in credits, and a request you can paste into a terminal.

At a glance

Made by: Alibaba
Output: Image
From: 3.6 credits per image ($0.036)
Typical time: about 44 s
Model IDs: alibaba/qwen-image-2.1/text-to-image
alibaba/qwen-image-2.1/edit

1 credit = $0.01. A task holds the highest possible charge when it is accepted and settles the real amount when it finishes, rounded up to whole credits; failed tasks are not charged. Ask POST /api/v1/jobs/quote for the exact figure before you run.

Create Image

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

Price

Option	Credits (per image)	US dollars
`1k`	3.6	$0.036
`1.5k`	7.2	$0.072
`2k`	7.2	$0.072

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	Describe the subject, composition, lighting, and any wording to render.
`aspect_ratio`Optional	`string`	`1:1`	1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, … (+1)	Output aspect ratio.
`resolution`Optional	`string`	`1k`	1k, 1.5k, 2k	Output resolution tier.
`enable_prompt_expansion`Optional	`boolean`	`true`	—	Rewrite the prompt into a fuller scene description before generating. On by default; turn it off to have the prompt followed word for word.
`background`Optional	`string`	`opaque`	opaque, transparent	opaque keeps a normal background; transparent returns the subject alone on a real alpha channel (needs output_format png or webp).
`output_format`Optional	`string`	`jpeg`	jpeg, png, webp	Container of the returned image.
`seed`Optional	`integer`	—	0 to 2147483647	Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

POST /api/v1/jobs/createTask

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/qwen-image-2.1/text-to-image",
  "input": {
    "prompt": "A cozy reading nook beside a rain-streaked window, warm lamp light, a sleeping orange cat on a knitted blanket, soft film grain",
    "resolution": "1k"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Edit Image

alibaba/qwen-image-2.1/edit

Price

Option	Credits (per image)	US dollars
`1k`	5.4	$0.054
`2k`	7.2	$0.072
`1.5k`	10.8	$0.108

Parameters

Field	Type	Default	Allowed	What it does
`prompt`Required	`string`	—	up to 5,000 characters	Describe the subject, composition, lighting, and any wording to render.
`image_urls`Required	`array<string (uri)>`	—	up to 10 items	One to ten reference images. Each one you add raises the quote.
`mask_url`Optional	`string (uri)`	—	—	Optional black-and-white mask for local editing: white is the area to repaint, black is kept. Use it with exactly one reference image.
`aspect_ratio`Optional	`string`	`1:1`	1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, … (+1)	Output aspect ratio.
`resolution`Optional	`string`	`1k`	1k, 1.5k, 2k	Output resolution tier.
`enable_prompt_expansion`Optional	`boolean`	`true`	—	Rewrite the prompt into a fuller scene description before generating. On by default; turn it off to have the prompt followed word for word.
`background`Optional	`string`	`opaque`	opaque, transparent	opaque keeps a normal background; transparent returns the subject alone on a real alpha channel (needs output_format png or webp).
`output_format`Optional	`string`	`jpeg`	jpeg, png, webp	Container of the returned image.
`seed`Optional	`integer`	—	0 to 2147483647	Random seed for controlled comparisons.

Example request

This request runs as it is; any field you leave out uses its default. Put your key in POPNOW_API_KEY first.

The example uses PopNow sample files in image_urls. Replace them with your own public HTTPS links, uploads or saved assets.

POST /api/v1/jobs/createTask?wait=60

curl -X POST "https://api.popnow.ai/api/v1/jobs/createTask?wait=60" \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "alibaba/qwen-image-2.1/edit",
  "input": {
    "prompt": "Change the orange jacket to deep forest green and add soft golden-hour light; keep the face, pose and background unchanged",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "resolution": "1k"
  }
}'

The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Qwen Image 2.1 API reference

At a glance

Create Image

Price

Parameters

Example request

Edit Image

Price

Parameters

Example request

Next steps

On this page