Qwen Image 3.0 API

Qwen Image 3.0: excellent Chinese/English text rendering, posters and precise editing.

Alibaba·ImageAvailable

from$0.019/ image~~$0.021~~10% off

Model IDqwen-image-3.0

Try in Playground View API

text-to-imageimage-edit

Input

Text · Image

Output

Image

Provider

4 providers

Aspect ratio

1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9

Resolution

1K · 2K

Images

1 – 4

Last 7 days · not enough recent requests for stats yet.

Qwen Image 3.0 pricing

Prices are per unit; requests without a provider are routed to the cheapest provider that supports your parameters.

Option	Price (USD)
All options	$0.019 / image 2 Credits~~$0.021~~10% off

Try Qwen Image 3.0 before you integrate

Test output quality, compare provider prices and estimate cost before writing any code.

Provider

Image

Estimated cost

Input

Prompt*prompt

Negative promptnegative_prompt

Reference imagesimage_urls

Aspect ratioaspect_ratio

Resolutionresolution

Imagesnum_images

Seedseed

Result

Idle

Your generation will appear here.

Provider prices for this request

Enter a prompt to compare provider prices.

Qwen Image 3.0 prompt examples

Ready-to-use prompts. Load one into the playground and tweak it.

Source

Scene

7 prompts

A cute baby koala holding a card that says "Qwen Image 3 is now available on fal" whil

A cute baby koala holding a card that says "Qwen Image 3 is now available on fal" while on a water slide

A young violinist performing alone on a rooftop at twilight, city skyline glowing behi

A young violinist performing alone on a rooftop at twilight, city skyline glowing behind her, wind moving her long coat, dramatic clouds above, emotional cinematic scene, elegant pose, realistic photography, wide-angle composition, soft blue and orange lighting.

A group of close friends celebrating on a rooftop overlooking a futuristic city, color

A group of close friends celebrating on a rooftop overlooking a futuristic city, colorful fireworks illuminating the night sky, champagne glasses raised, laughter frozen in time, cinematic lighting, emotional storytelling, shallow depth of field, anamorphic lens, ultra realistic, 8K

Koala with a sign

Text rendering

A baby koala riding down a bright water slide, holding a card that reads "Qwen Image 3 is here", splashes, sunny day, playful photo style.

Bilingual tea poster

Poster

Elegant tea shop poster with the Chinese title "春日新茶" and the English line "Spring Harvest Tea", a celadon teacup, steam and plum blossoms, ink-wash background.

Rooftop violinist

Photography

A young woman playing violin alone on a rooftop at twilight, glowing city skyline, coat blowing in the wind, dramatic clouds, blue and orange light, wide-angle realistic photo.

Qwen Image 3.0 API reference

Endpoints, request fields and runnable examples for this model.

Base URL

https://01router.com/api/v1

llms.txt

Quick start

Set API_KEY to your project key, then run a sample from your server. Replace example media URLs with your own public URLs.

Auto-routing chooses a provider that supports the request. Select a provider to see its input constraints and pinned request examples.

curl https://01router.com/api/v1/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "model": "qwen-image-3.0",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}
JSON

# Replace GENERATION_ID with the id returned above; poll until status is "succeeded" or "failed"
curl https://01router.com/api/v1/generations/GENERATION_ID -H "Authorization: Bearer $API_KEY"

Endpoints

Only endpoints relevant to this model are listed. Paths below include /api/v1. Click an endpoint to read its usage.

POST

/api/v1/generations

Create a generation (charges credits) · API key required

GET

/api/v1/generations/{id}

Get a generation; polls the provider while running · API key required

POST

/api/v1/generations/{id}/cancel

Cancel a running generation (credits refunded) · API key required

POST

/api/v1/quote

Price a request on every provider (no charge, no key needed) · Public · no key

POST

/api/v1/images/generations

OpenAI-compatible image generation (waits for the result) · API key required

GET

/api/v1/models/qwen-image-3.0

Get one model · Public · no key

Authentication

Send your API key as a Bearer token. Requests are billed to the key owner's credits.

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Get an API key

Input

Send JSON with Content-Type: application/json. Model parameters belong inside input; model, provider and callback_url are top-level fields.

Request body

Name	Type	Required	Description
model	string	Yes	"qwen-image-3.0"
provider	string	No	Pin a provider; omit to auto-route to the cheapest. One of: fal \| wavespeed \| apimart \| atlascloud
input	object	Yes	Model parameters, see the input fields below.
callback_url	string	No	Optional public HTTPS webhook URL. The final task result is signed and delivered here; polling remains available.

input · input fields

Required fields are marked explicitly. Other fields use the listed defaults when omitted.

Name	Type	Required	Values	Default
prompt*	string	Yes	—	—
negative_prompt	string	No	—	—
image_urls Optional — switches to image editing	string[]	No	maxItems: 3	—
aspect_ratio	string	No	1:1 \| 16:9 \| 9:16 \| 4:3 \| 3:4 \| 3:2 \| 2:3 \| 21:9	1:1
resolution	string	No	1K \| 2K	1K
num_images	integer	No	min: 1 · max: 4	1
seed	integer	No	min: 0 · max: 2147483647	—

Callbacks →

Output

Creating a task does not mean generation has finished. Keep its id, poll until succeeded or failed, then read outputs or error. Amounts below are illustrative; actual charges depend on the request.

queued→processing→succeeded / failed

Task submitted

{
  "id": "gen_example",
  "object": "generation",
  "model": "qwen-image-3.0",
  "type": "image",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}

Task completed

{
  "id": "gen_example",
  "object": "generation",
  "model": "qwen-image-3.0",
  "type": "image",
  "provider": "fal",
  "status": "succeeded",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  },
  "outputs": [
    "https://example.com/output.png"
  ],
  "error": null,
  "credits": 0,
  "price_usd": 0,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": "2026-10-25T08:01:00.000Z"
}

Response fields

Name	Type	Required	Description
id	string	Yes	Generation ID. Use it to query or cancel this task.
object	string	Yes	generation
model	string	Yes	qwen-image-3.0
type	string	Yes	image
provider	string	Yes	Provider
status	string	Yes	queued → processing → succeeded / failed. Stop polling at either terminal state.
input	object	Yes	Model parameters, see the input fields below.
outputs	string[]	Yes	Result URLs. Empty while processing; read after succeeded and save the files promptly.
error	string \| null	Yes	Failure reason, or null when no failure is reported.
credits	number	Yes	Credits charged for this request.
price_usd	number	Yes	Request price in USD.
created_at	string	Yes	Creation time in ISO 8601 format.
completed_at	string \| null	Yes	Completion time in ISO 8601 format; null before completion.

Get the result

Poll every few seconds until status is succeeded or failed. Output URLs are provider-hosted and may expire — download them promptly. Or pass callback_url to get the result pushed.

curl "https://01router.com/api/v1/generations/GENERATION_ID" \
  -H "Authorization: Bearer $API_KEY"

queued → processing → succeeded / failed. Stop polling at either terminal state. Result URLs. Empty while processing; read after succeeded and save the files promptly.

Cancel a task

Cancellation depends on provider support and task state. A confirmed cancellation returns status: failed and error: Canceled by user. Unsupported or completed tasks return 409 not_cancelable.

curl -X POST "https://01router.com/api/v1/generations/GENERATION_ID/cancel" \
  -H "Authorization: Bearer $API_KEY"

Quote

Same body as creating a generation. Returns every available provider sorted by price, plus the ones that cannot serve the request and why.

curl "https://01router.com/api/v1/quote" -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "qwen-image-3.0",
  "input": {
    "prompt": "A cinematic shot of a red fox running through snow",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "num_images": 1
  }
}
JSON

OpenAI-compatible images

For OpenAI SDK integrations, use this endpoint with top-level prompt. It waits for the result and returns data[].url. For asynchronous tasks and the full model parameter set, use /generations.

curl "https://01router.com/api/v1/images/generations" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" --data-binary @- <<'JSON'
{
  "model": "qwen-image-3.0",
  "prompt": "A cinematic shot of a red fox running through snow"
}
JSON

{
  "created": 1792915200,
  "data": [
    {
      "url": "https://example.com/output.png"
    }
  ]
}

Model schema

This public endpoint returns the model parameters and each provider’s supported constraints and prices.

curl "https://01router.com/api/v1/models/qwen-image-3.0"

Errors

Check the HTTP status and error.message. Fix the request before retrying validation or authentication errors. A failed generation is reported in status and error on the task itself.

{
  "error": {
    "message": "Invalid or missing API key",
    "code": "unauthorized"
  }
}

400Invalid body or parameter value

401Missing or invalid API key

402Not enough credits

404Unknown model or generation

409The task cannot be canceled (already finished, or the provider does not support canceling)

429Too many requests — retry after the given seconds

502Every provider rejected the task (credits refunded)

Auth, routing, billing and error codes are covered in →

Use with AI

Give your coding assistant this model reference: endpoints, input constraints, output fields and request examples in plain text.

Open llms.txt

How does Qwen Image 3.0 compare?

Specs and starting prices side by side. Test with the same prompt before you choose.

	Qwen Image 3.0	Z-Image Turbo	GPT Image 2.5 Flare	GPT Image 2.5 Sunburst
Vendor	Alibaba	Alibaba	OpenAI	OpenAI
Starting price	$0.019 / image	$0.0035 / image	$0.0053 / image	$0.0053 / image
Input	Text · Image	Text	Text · Image	Text · Image
Provider	4 providers	7 providers	6 providers	6 providers
Aspect ratio	1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9	1:1 · 16:9 · 9:16 · 4:3 · 3:4	1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3	1:1 · 4:3 · 3:4 · 16:9 · 9:16 · 3:2 · 2:3
Resolution	1K · 2K	—	—	—
Images	1 – 4	1 – 4	1 – 4	1 – 4

Qwen Image 3.0 API FAQ

What is Qwen Image 3.0 good at?

Alibaba's Qwen Image 3.0 is known for reliable Chinese and English text inside images, which makes it a strong choice for posters, menus, covers and layout drafts.

Does it support negative prompts?

Yes. Use negative_prompt to list things to avoid, such as blurry text or watermarks.

Can I edit images?

Some providers support editing with reference images in image_urls; others offer text-to-image only. The playground shows which providers accept your inputs.

Which sizes are supported?

1K or 2K with aspect ratios from 1:1 to 21:9, and up to 4 images per request.

How is it billed on 01router?

Per generated image; see the pricing table for each provider. Failed generations are refunded.

Related models

Other models you can call with the same API key.

Image · Alibaba

Z-Image Turbo

Tongyi Z-Image Turbo: sub-second, very low-cost photoreal images with bilingual text.

from $0.0035 / imageView API

Image · OpenAI

GPT Image 2.5 Flare

OpenAI GPT Image 2.5 Flare: fast everyday generation and editing with precise text rendering.

from $0.0053 / imageView API

Image · OpenAI

GPT Image 2.5 Sunburst

OpenAI GPT Image 2.5 Sunburst: tighter control for demanding edits and premium creative.

from $0.0053 / imageView API

Image · Google

Nano Banana 2.1

Google Gemini image model: consistent multi-reference editing, 1K–4K output.

from $0.018 / imageView API

Image · ByteDance

Seedream 5.0 Pro

ByteDance Seedream 5.0 Pro: photoreal images, multilingual text and up to 10-reference editing.

from $0.026 / imageView API

Image · Google

Nano Banana 2

Gemini 3.1 Flash Image: fast generation and editing with strong text rendering, 1K–4K.

from $0.036 / imageView API