Qwen Image 3.0 Pro API

Introduction

Qwen Image 3.0 Pro Text to Image is the finishing tier of the line. It takes the same request as Qwen Image 3.0 and spends more on detail — most visibly on multi-element typography and on material rendering in skin, fabric and glass.

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

Start from a written brief

Use this tier when the frame will ship as it comes back and carries several pieces of type: a masthead, a date line, a short claim. Keep resolution at 2k, quote every string, and say where each one sits.

Packaging and label mockups

Bottle, box and tin labels where the brand name and a short claim have to be legible on a curved surface. Quote each string, name the material, and let the negative prompt handle stray duplicated lettering.

Poster and out-of-home comps

Enough to take into a review before anyone sets real type over a clean plate.

Prompt guide & pro tips

Quote every string and say where it sits

Name the masthead, the cover lines and the small caps separately, each in single quotes and each with a position. Three or four short strings per frame is the reliable range; negative_prompt can keep duplicated lettering and stray watermarks out.

Pin the seed, then vary one line

Once the layout lands, record the seed and change a single cover line at a time. When you want several readings of the same layout instead of one committed frame, leave the seed out and send the brief as parallel requests.

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.

The exact request behind the cover shown for this endpoint: a 3:4 full-bleed portrait at 2k with masthead, issue line and cover lines all quoted in the prompt.

Check the result before iterating

Multi-element typography is the reason to use this tier, and it still has a ceiling: three or four short strings per frame is reliable, a full page of body copy is not. Generate type at 2k — the 1k tier is for composition roughs. Rare glyphs and non-Latin scripts render but need proofreading before anything ships.

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/text-to-image 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/text-to-image",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "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