Qwen Image 2.1 Pro API reference
Up to six detailed 2K images from one prompt
Call Qwen Image 2.1 Pro 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
- 5.4 credits per image ($0.054)
- Typical time
- about 53 s
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-pro/text-to-image
Price
| Option | Credits (per image) | US dollars |
|---|---|---|
Default | 5.4 | $0.054 |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | Describe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt. |
aspect_ratioOptional | 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. |
resolutionOptional | string | 2k | 1k, 1.5k, 2k | Output resolution tier. Every tier costs the same. |
num_outputsOptional | integer | 1 | 1 to 6 | How many images to generate in one request (1 to 6). Billed per image returned. |
enable_prompt_expansionOptional | boolean | false | — | Let the service rewrite and expand the prompt before generating. Off by default so the prompt is followed word for word. |
enable_thinkingOptional | boolean | true | — | Spend extra reasoning on the rewrite for better images, at the cost of a longer wait. Only works while prompt expansion is on. |
prompt_optimization_modeOptional | string | direct | direct, agent | How prompt expansion rewrites the brief: direct is a single pass that suits most prompts; agent is a multi-step rewrite with finer detail. |
seedOptional | 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.
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-pro/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",
"num_outputs": 1
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
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-pro/edit
Price
| Option | Credits (per image) | US dollars |
|---|---|---|
Default | 5.4 | $0.054 |
Parameters
| Field | Type | Default | Allowed | What it does |
|---|---|---|---|---|
promptRequired | string | — | up to 5,000 characters | Describe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt. |
image_urlsRequired | array<string (uri)> | — | up to 10 items | One to ten source images, in the order you refer to them in the prompt (Image 1, Image 2 and so on). |
aspect_ratioOptional | string | — | 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. Omit it to let the model choose a size from the source images. |
resolutionOptional | string | 2k | 1k, 1.5k, 2k | Output resolution tier. Every tier costs the same. |
num_outputsOptional | integer | 1 | 1 to 6 | How many images to generate in one request (1 to 6). Billed per image returned. |
enable_prompt_expansionOptional | boolean | false | — | Let the service rewrite and expand the prompt before generating. Off by default so the prompt is followed word for word. |
enable_thinkingOptional | boolean | true | — | Spend extra reasoning on the rewrite for better images, at the cost of a longer wait. Only works while prompt expansion is on. |
seedOptional | 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.
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-pro/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"
],
"num_outputs": 1
}
}'The response carries a taskId straight away. Read the result with GET /api/v1/jobs/recordInfo, or add callBackUrl to be notified.
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
-H "Authorization: Bearer $POPNOW_API_KEY"