Qwen Image 3.0 Pro API
imageImage generation by alibaba
Alibaba Qwen image generation and editing with up to three reference images.
Call Qwen Image 3.0 Pro from Node.js, Python, or any HTTP client. No GPU provisioning, no cold starts, no Docker images — just an API key and a prompt.
Pay per request. Powering 1M+ generations daily.

Start in 60 seconds
Install the official SDK for Node.js or Python, drop in your API key, and generate your first image.
npm install getimg-ai
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "qwen-image-3-0-pro",
prompt: "ultra high-end fashion editorial close-up portrait of a dark-skinned woman partially wrapped in flowing translucent fabric, tightly cropped around the face, neck and shoulders",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg"
});
console.log(result.data[0].url);How Qwen Image 3.0 Pro API works
Send a prompt, get an image URL back — one synchronous call.
Get your API key
Create a key in the Developer Dashboard. Add credit and start calling — you are billed per request.
Send a request
POST to /v2/images/generations with your prompt and output format.
Get your image
The response includes the image URL plus a usage object with the exact cost.
What you can build with Qwen Image 3.0 Pro
Every example uses the same authentication and works with the official getimg-ai and getimg SDKs, or plain HTTP.
Text to image
Generate an image using just a text prompt.
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "qwen-image-3-0-pro",
prompt: "ultra high-end fashion editorial close-up portrait of a dark-skinned woman partially wrapped in flowing translucent fabric, tightly cropped around the face, neck and shoulders",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg"
});
console.log(result.data[0].url);Image editing
Edit or restyle an existing image with an instruction-based prompt.
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "qwen-image-3-0-pro",
prompt: "Restyle the subject in warm cinematic studio lighting.",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg",
images: [
{
url: "https://your-bucket.s3.amazonaws.com/source.png"
}
]
});
console.log(result.data[0].url);Multi-reference generation
Combine up to 3 reference images for character consistency, style, or composition guidance.
import GetimgAI from "getimg-ai";
const client = new GetimgAI();
const result = await client.images.generate({
model: "qwen-image-3-0-pro",
prompt: "A product hero shot blending the style of the reference images.",
aspect_ratio: "1:1",
resolution: "1K",
output_format: "jpeg",
images: [
{
url: "https://your-bucket.s3.amazonaws.com/reference-1.png"
},
{
url: "https://your-bucket.s3.amazonaws.com/reference-2.png"
}
]
});
console.log(result.data[0].url);Qwen Image 3.0 Pro pricing
Pay per image. No subscriptions, no minimums, no idle GPU costs.
Qwen Image 3.0 Pro
$0.04 – $0.075 /image
/v2/images/generationsAlibaba Qwen image generation and editing with up to three reference images.
| Resolution | Price | Images for $10 |
|---|---|---|
| 1K | $0.04 /image | 250 |
| 2K | $0.075 /image | 133 |
More from alibaba
Other alibaba models available through the same API.
Wan 3.0
Alibaba Wan 3.0 video generation with native audio, first/last frame control, and reference images. First/last frame and reference images cannot be combined in one request.
HappyHorse 1.1
Physically realistic, motion-smooth video generation with text, first-frame, and reference-image guidance.
HappyHorse 1
Physically realistic, motion-smooth video generation with text, first-frame, and reference-image guidance.

Wan 2.7 Image
Fast Wan 2.7 image model supporting text-to-image and reference-based editing.
Wan 2.7
Multimodal Wan 2.7 video generation with text, frame control, and reference-image guidance.

Wan 2.7 Image Pro
Wan 2.7 image pro model with higher-fidelity generation and extended resolution support.
Qwen Image 3.0 Pro API — frequently asked questions
How do I use the Qwen Image 3.0 Pro API?
Install the official Node.js (npm install getimg-ai) or Python (pip install getimg) SDK, or call the endpoint directly over HTTP from any client.
Make a POST request to /v2/images/generations with your API key and a JSON body containing the model ID (qwen-image-3-0-pro) and a prompt. The response includes the generated image URL.
See the API documentation for the full parameter reference.
Which SDK should I use?
Use getimg-ai for Node.js and TypeScript projects, and getimg for Python. Both wrap the same REST API with typed inputs, retries, and built-in polling for video generations.
For other languages — Go, Rust, Java, Ruby, PHP — call the HTTP endpoints directly. Every example on this page includes a cURL snippet you can port to any HTTP client.
What resolutions does Qwen Image 3.0 Pro support?
Qwen Image 3.0 Pro supports the following resolutions: 1K, 2K across 5 aspect ratios (1:1, 4:3, 3:4, 16:9, 9:16).
How much does Qwen Image 3.0 Pro cost?
Qwen Image 3.0 Pro uses pay-per-image pricing with no subscriptions or minimum commitments. Rates vary by resolution. See the pricing table above for exact rates per image.
Does Qwen Image 3.0 Pro support reference images?
Yes. Qwen Image 3.0 Pro accepts up to 3 reference images. Reference images guide the generation toward a specific style, composition, or subject. See the example above.
Start building with Qwen Image 3.0 Pro
Grab an API key, install the SDK, ship image generation today.
Looking for other models? View all available models