MiniMax H3 Open Weights | Try in Video Generator →
Alibaba·image·From $0.030/run

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.

Qwen Image 3.0 sample output

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 preview from Alibaba

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.

text-to-imagefrom $0.030
Qwen Image 3.0 Edit — Qwen Image 3.0 image-to-image preview from Alibaba

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.

image-to-imagefrom $0.030
Qwen Image 3.0 Pro Text To Image — Qwen Image 3.0 text-to-image preview from Alibaba

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.

text-to-imagefrom $0.040
Qwen Image 3.0 Pro Edit — Qwen Image 3.0 image-to-image preview from Alibaba

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.

image-to-imagefrom $0.040

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. 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. 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. 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. 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.

standardtext-to-image1k-2k

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.

protext-to-imageproduction

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.

editingreferencesinstructions

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.

resolutionaspect-ratiocreative-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).

EndpointTypeStarting price
alibaba/qwen-image-3.0/text-to-imagetext-to-image$0.030
alibaba/qwen-image-3.0/editimage-to-image$0.030
alibaba/qwen-image-3.0-pro/text-to-imagetext-to-image$0.040
alibaba/qwen-image-3.0-pro/editimage-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
done
Node.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.

Qwen Image 3.0 API — AI Image Generation & Editing | WaveSpeedAI