Qwen Image 3.0 API

About Qwen Image 3.0

Qwen Image 3.0 is Alibaba's text-rendering image model: 5,000-character prompts, eight aspect ratios, a 1K or 2K tier, and an editing endpoint that reads one to three references.

Call it with the model name alibaba/qwen-image-3.0/text-to-image on POST /jobs/createTask, from 5 credits per image ($0.05). New accounts get 30 free credits to try it in the Playground first.

Introduction

Qwen Image 3.0 Text to Image turns a written brief into one image per request. Its distinguishing behaviour is typography: strings you put in quotes — a door hanger, a bar sign, a poster headline — are rendered as text rather than as letter-shaped texture.

Qwen Image 3.0 is Alibaba's text-rendering image model: 5,000-character prompts, eight aspect ratios, a 1K or 2K tier, and an editing endpoint that reads one to three references.

Choose a Qwen Image 3.0 mode by starting material

Key features

Text-aware image composition

Qwen Image 3.0 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.

Each task is rounded up to whole credits, so one run at the lowest tier costs 5 credits per image ($0.05).

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

Use cases

Start from a written brief

Use this mode when the picture has no source yet and some of its wording has to read: a sign, a label, a headline. Choose the ratio you will publish at, keep resolution at 2k, and put each string in single quotes inside the prompt.

Character sets and fashion series

Pin the seed that gave you the character, then change one detail per request — wardrobe, light, pose — for a coherent set rather than a pile of unrelated draws.

Poster and packaging comps

Headline, subhead and a legal line, all rendered in the frame at 2k, in the ratio the placement actually uses. Useful for pitching a layout before a designer sets real type over a clean plate.

Hospitality and set-dressing plates

Hotel rooms, bars and lobbies where a specific sign has to read correctly: door hangers, room numbers, cocktail menus, neon above the back bar. Generate the plate with the wording already in place instead of compositing type over a render afterwards.

Prompt guide & pro tips

Choose the ratio and the tier first

aspect_ratio composes the frame, it does not crop one, so pick the shape you will publish at. Leave resolution at 2k whenever the image contains text; drop to 1k only for layout roughs where nothing has to be readable.

Write the scene and quote the wording verbatim

Describe subject, wardrobe, light and lens, then put each exact string in single quotes and keep it to roughly eight words. enable_prompt_expansion is on by default and rewrites detailed prompts, so turn it off once your wording is a precise shot description.

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 published still: a 3:4 hotel scene at the 2k tier with the door-hanger wording quoted in the prompt.

Check the result before iterating

Short quoted strings are the reliable case: a masthead, a sign, a label, roughly eight words or fewer per element. Paragraph-length body copy still degrades into plausible-looking nonsense, and dense small type is the first thing to break at the 1k tier — generate typography at 2k. Non-Latin scripts render, but proofread them; the model is more confident than it is correct on rare glyphs.

API quick start

Call the Qwen Image 3.0 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/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/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 API questions

All Qwen Image models

Qwen Image 3.0 Pro raises the ceiling on multi-line typography and fine texture for the final frame.

• 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

Try it

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

Docs

Qwen Image 3.0 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 results without polling