Qwen Image 3.0 Pro API

Introduction

Qwen Image 3.0 Pro Image to Image edits one to three reference images under an instruction. With one reference it is a surgical change — a cover line, a garment, a light. With two or three it merges, provided the prompt says which source contributes what.

Qwen Image 3.0 Pro is the high-detail tier of Alibaba's Qwen image line: 5,000-character prompts, eight aspect ratios, a 1K or 2K tier, and one-to-three-reference editing.

Choose a Qwen Image 3.0 Pro mode by starting material

Key features

Text-aware image composition

Qwen Image 3.0 Pro is useful for visual concepts in which supplied wording, composition and image treatment must be considered together. Treat generated lettering as a design draft and proofread it before publication.

New composition and source-led revision are separate jobs

Use text-to-image to establish a visual from a written brief. Use image editing when an existing image supplies the identity, layout or material that must be retained while a defined change is made.

Review hierarchy before decorative detail

For posters, packaging and campaign concepts, decide the message hierarchy and focal area first. A visually appealing result still fails the assignment if the approved copy or product facts are not represented correctly.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Refine a supplied visual

Use this mode when one to three approved frames should carry into the result. List them in image_urls in the order your prompt refers to them and give each a role — the face from the first, the garment from the second — because roles are never inferred.

Poster and out-of-home comps

Quote the old and the new string, keep aspect_ratio at the frame's shape, and describe everything else as unchanged.

Packaging and label mockups

Send a product render and relabel it: quote the brand name and the short claim, say which surface they sit on, and use negative_prompt against leftover lettering from the old label.

Prompt guide & pro tips

Set the cover shape and stay at 2k

Pick 3:4 or 2:3 for covers and posters; the frame is composed for that shape rather than cropped into it. Leave resolution at 2k for anything with type — this tier's advantage disappears at 1k.

Quote every string and say where it sits

For a text edit, quote the old string and the new one and name the position, then say which elements must stay untouched, such as the masthead. Anything the instruction does not mention is open to being redrawn.

Adapt the included example

Start with the published example using aspect_ratio: 3:4, resolution: 2k. Replace the subject and creative direction while keeping the input contract for this mode intact.

Keep the portrait, wardrobe, lighting and grade exactly as they are. Change the cover line from 'THE LATE SHIFT' to 'AFTER HOURS' in the same small caps and the same position, and leave the masthead untouched.

Supply your own cover frame — the image_urls value is a placeholder, not a hosted sample.

Check the result before iterating

Merging works when the prompt assigns a role to each reference; with three sources and no roles named the result is a blend nobody asked for. Retyping in place needs both the old and the new string quoted. Faces drift when you restyle and retype in the same call, so split those into two passes.

API quick start

Call the Qwen Image 3.0 Pro API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model alibaba/qwen-image-3.0-pro/edit and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
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: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/qwen-image-3.0-pro/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "1:1",
    "resolution": "2k",
    "num_outputs": 1
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Qwen Image 3.0 Pro API questions

All Qwen Image models

Qwen Image 3.0 takes exactly the same prompts for a little less and is the place to explore. Pro has the higher ceiling on typography and fine material.

• Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
• Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image
• Qwen Image 2.1 APIOpen model with 2K output and transparent backgroundsFrom 4 credits per image
• Qwen Image 2.1 LoRA APIQwen Image 2.1 images and edits with up to three of your LoRAsFrom 5 credits per image
• Qwen Image 3.0 Pro APIFine typography plus lifelike skin, fabric and glassFrom 6 credits per image
• Qwen Image 3.0 APIReadable signs and headlines rendered into the imageFrom 5 credits per image
• Qwen Image 2 APISimple prompt-to-image and one-photo editsFrom 6 credits per image
• Qwen Image 2512 LoRA APIQwen Image 2512 renders and edits with your own LoRAsFrom 5 credits per image
• Qwen Image Edit 2509 LoRA APIMulti-photo Qwen edits that load your own LoRAsFrom 5 credits per image
• Qwen Image 1.0 LoRA APIOriginal Qwen-Image with clean lettering and your own LoRAsFrom 5 credits per image

Other image APIs

• Nano Banana 2.1 APIGoogle's newest Nano Banana, sharp text and 4K outputFrom 8 credits per image
• Nano Banana Pro APIPlans the layout first: dense text, diagrams and 4K editsFrom 17 credits per image
• GPT Image 2.5 Sunburst APIOpenAI's quality-first model, up to 4K with clean textFrom 1 credit per image
• Seedream 5.0 Pro APIHigh-detail images and edits from up to ten referencesFrom 6 credits per image
• FLUX.2 Max APITop-tier FLUX: photoreal light and exact brand colorsFrom 11 credits per image

More about Qwen Image 3.0 Pro

Try it

Qwen Image 3.0 Pro AI Image Generator onlineCreate images with Qwen Image 3.0 Pro in PopNow

Docs

Qwen Image 3.0 Pro model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get Qwen Image 3.0 Pro results without polling