Qwen Image 3.0 API
Alibaba Qwen Image 3.0 — Standard and Pro text-to-image and image-edit endpoints with flexible aspect ratios, 1K/2K output, and natural-language instruction understanding.
Qwen Image 3.0 provides Standard and Pro text-to-image and editing endpoints. Choose the Standard tier for consistent 1K/2K generation and editing, or Pro for higher-fidelity output with resolution-based pricing.

About the Qwen Image 3.0 API
What Qwen Image 3.0 does, how it fits in the Alibaba model lineup, and why teams reach for it.
Qwen Image 3.0 is a image generation and editing model from Alibaba, available through the WaveSpeedAI REST API. Alibaba Qwen Image 3.0 — Standard and Pro text-to-image and image-edit endpoints with flexible aspect ratios, 1K/2K output, and natural-language instruction understanding.
Qwen Image 3.0 provides Standard and Pro text-to-image and editing endpoints. Choose the Standard tier for consistent 1K/2K generation and editing, or Pro for higher-fidelity output with resolution-based pricing.
The Qwen Image 3.0 family on WaveSpeedAI ships 4 REST endpoints covering Text-To-Image, Image-To-Image workflows. Each variant carries its own pricing, parameter knobs, and example outputs — pick the one that matches your input modality and production constraints, or call several from the same API key to compose multi-step pipelines.
Run Qwen Image 3.0 through the same API key, billing account, and rate-limit envelope you use for the other 1,000+ AI models on WaveSpeedAI. No separate vendor setup, no per-provider SDKs, no per-vendor rate-limit envelopes — one integration covers everything from text-to-image and text-to-video through audio synthesis, 3D generation, upscaling, and editing.
All Qwen Image 3.0 API endpoints
4 Qwen Image 3.0 endpoints available now on WaveSpeedAI — pick the variant that matches your workflow.

Qwen Image 3.0 Text To Image
Qwen Image 3.0 Text to Image is a high-quality image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Qwen Image 3.0 Edit
Qwen Image 3.0 Edit is a high-quality image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Qwen Image 3.0 Pro Text To Image
Qwen Image 3.0 Pro Text-to-Image is a professional-grade image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Qwen Image 3.0 Pro Edit
Qwen Image 3.0 Pro Edit is a professional-grade image editing model that transforms existing images with natural-language instructions, delivering advanced instruction understanding, superior visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
See Qwen Image 3.0 in action
Real outputs generated by the Qwen Image 3.0 API. Hover any video to preview, click to open the full-size viewer.
How to use the Qwen Image 3.0 API
Four steps from signup to a finished generation. Full Python, Node.js, and cURL examples are in the API section below.
- 1
Get an API key
Sign up for a WaveSpeedAI account and copy your API key from the dashboard. New accounts come with free starter credits — enough to run the playground a few dozen times before billing kicks in.
- 2
Submit a prediction
POST your input as JSON to https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image. The endpoint returns a prediction id immediately — generations are async so you don't hold an open connection during inference.
- 3
Poll for completion
GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Start around every 2 seconds, then increase toward 5-10 seconds for long-running tasks to reduce unnecessary requests. Stop on completed, failed, cancelled, or timeout.
- 4
Read the output URL
Once status is"completed", read the URL from data.outputs[0]. The URL points to your generated media on the WaveSpeedAI CDN — image, video, audio, or 3D file depending on the Qwen Image 3.0 variant you called.
What you can build with Qwen Image 3.0
Common workflows developers and creators use the Qwen Image 3.0 API for.
Standard text-to-image generation
alibaba/qwen-image-3.0/text-to-image creates images from natural-language prompts with flexible aspect ratios and 1K or 2K resolution tiers.
Pro image generation for production work
alibaba/qwen-image-3.0-pro/text-to-image provides the Pro generation tier for detailed visual creation, prompt adherence, and higher-fidelity production output.
Natural-language image editing
The Standard and Pro edit endpoints transform 1 to 3 reference images with natural-language instructions while preserving the requested visual context.
Resolution-aware creative workflows
Select 1K or 2K output and choose an aspect ratio before generation or editing to fit marketing, product, portrait, and creative delivery workflows.
Tips for prompting Qwen Image 3.0
Practical advice for getting better outputs from Qwen Image 3.0 — drawn from the patterns that work across image models in production pipelines.
Describe lighting, composition, and style — not just subject
Move past 'a cat' to 'a tabby cat on a windowsill, soft afternoon light streaming in, shallow depth of field, cinematic 35mm composition'. Subject + scene + lighting + camera language is the prompt formula that pulls best from image-model training data.
Use style anchors instead of artist names
'In the style of editorial photography' or 'studio product shot, white seamless background' beats vague 'high quality, masterpiece' boilerplate AND avoids the legal / licensing concerns that come with naming living artists in commercial work.
Specify resolution and aspect ratio explicitly
Don't rely on defaults. Set the target aspect ratio (1:1, 4:3, 16:9) and resolution up front. Cropping or upscaling later loses fidelity that the model could have placed correctly in the first generation.
Iterate on a locked seed before re-rolling
Lock the seed, change one prompt element at a time. Much faster than re-rolling random seeds for every change — you isolate cause-and-effect on each prompt edit and reach the target image with fewer total generations.
Use the edit endpoint for refinements, not full re-generation
Generate the base image once, then use the model's edit / inpaint endpoint to refine specific elements — text, lighting, individual subjects. Edits preserve everything you liked about the base and cost less per iteration than full re-generations.
Qwen Image 3.0 API pricing
Pricing is per-output. The final charge scales with the parameters you set in each variant's playground (resolution, duration, output count, references).
| Endpoint | Type | Starting price |
|---|---|---|
| alibaba/qwen-image-3.0/text-to-image | text-to-image | $0.030 |
| alibaba/qwen-image-3.0/edit | image-to-image | $0.030 |
| alibaba/qwen-image-3.0-pro/text-to-image | text-to-image | $0.040 |
| alibaba/qwen-image-3.0-pro/edit | image-to-image | $0.040 |
Call the Qwen Image 3.0 API
Sign up for an API key at wavespeed.ai/accesskey, then submit a prediction via REST. The playground generates ready-to-paste samples for any combination of inputs.
HTTP example
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL=$(printf '%s' "$TASK" | jq -r '.urls.get // empty')
if [ -z "$RESULT_URL" ]; then
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
fi
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
created|processing) sleep 2 ;;
*) printf 'Unexpected status: %s
' "$STATUS" >&2; exit 1 ;;
esac
doneNode.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({}),
});
const task = body.data ?? body;
const resultUrl = task.urls?.get ||
`https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout"].includes(result.status)) throw new Error(JSON.stringify(result));
if (!["created", "processing"].includes(result.status)) throw new Error("Unexpected status: " + result.status);
await new Promise(resolve => setTimeout(resolve, 2000));
}Python example
import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = task.get("urls", {}).get("get") or f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout"}:
raise RuntimeError(result)
if status not in {"created", "processing"}:
raise RuntimeError(f"Unexpected status: {status}")
time.sleep(2)Qwen Image 3.0 vs alternatives
When to pick Qwen Image 3.0 over similar models on WaveSpeedAI.
Qwen Image 3.0 vs Seedream 5 Pro
Seedream 5 Pro emphasizes design understanding, multi-reference editing, and output format controls. Qwen Image 3.0 provides a focused Standard/Pro surface with natural-language generation and editing across 1K and 2K tiers.
Qwen Image 3.0 vs Qwen Image 2.0
Qwen Image 2.0 is the earlier Qwen family generation and editing surface. Qwen Image 3.0 uses dedicated Alibaba Standard and Pro endpoints with updated generation and editing behavior.
Qwen Image 3.0 API — Frequently asked questions
Pricing, license, integration — common questions about running Qwen Image 3.0 on WaveSpeedAI.
What is the Qwen Image 3.0 API?
Qwen Image 3.0 is a Alibaba image generation model exposed as a REST API on WaveSpeedAI. Alibaba Qwen Image 3.0 — Standard and Pro text-to-image and image-edit endpoints with flexible aspect ratios, 1K/2K output, and natural-language instruction understanding. You can call it programmatically or try it from the playground linked above.
How do I call the Qwen Image 3.0 API?
Sign up for a WaveSpeedAI account, copy your API key from /accesskey, then POST to https://api.wavespeed.ai/api/v3/alibaba/qwen-image-3.0/text-to-image with your input as JSON. The endpoint returns a prediction id. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. Production-oriented Python / Node.js / cURL examples are above.
How much does the Qwen Image 3.0 API cost?
Qwen Image 3.0 starts at $0.030 per run. The exact cost scales with the parameters you set (resolution, duration, output count, references). The live cost preview next to the Generate button in the playground shows the exact price for your current input.
Which Qwen Image 3.0 variants are available?
WaveSpeedAI hosts 4 live Qwen Image 3.0 endpoints: alibaba/qwen-image-3.0/text-to-image, alibaba/qwen-image-3.0/edit, alibaba/qwen-image-3.0-pro/text-to-image, alibaba/qwen-image-3.0-pro/edit. Each variant has its own playground page and pricing.
Can I use Qwen Image 3.0 outputs commercially?
Commercial usage rights follow the Alibaba model license. Most Alibaba models permit commercial output use; see each model's playground page for the specific license summary, and WaveSpeedAI's Terms of Service for platform-level conditions.
Why use Qwen Image 3.0 on WaveSpeedAI instead of going direct?
One API key + one billing account across Qwen Image 3.0 AND 1,000+ other AI models from other providers. No per-vendor SDK setup, no separate rate-limit envelopes, no rewrite-per-vendor integration code. Pricing is typically at parity with or below Alibaba's direct API.
About Alibaba
The team behind Qwen Image 3.0 and the broader Alibaba model lineup on WaveSpeedAI.
Alibaba's Tongyi Lab produces the Wan family of video models and the Qwen family of LLMs. Wan is notable for being released with open weights, broad variant coverage (text-to-video, image-to-video, reference-to-video, video-edit, video-extend, image-edit, text-to-image), and consistent strength on motion stability and prompt adherence across multilingual prompts.
Start building with Qwen Image 3.0 on WaveSpeedAI
Free starter credits on signup. One API key across 1,000+ AI models from Alibaba and every other provider.


