img_uuid, then poll or use callbacks. GoEnhance provides independent access and is not Alibaba's official API.Qwen-Image 3.0 Pro API
Access Qwen-Image 3.0 Pro through GoEnhance with one endpoint for text-to-image generation and reference-guided editing. Submit a prompt, optionally add up to three image URLs, receive an
Create an API Key
One Endpoint for Generation and Editing
Generate from a Prompt
Omit image_list for pure text-to-image generation. Choose a supported ratio and 1K or 2K output, or let ratio: auto select the composition.
Edit with Up to Three References
Add one to three accessible image URLs in image_list. Their order controls how the prompt refers to each source; every reference must be under 10MB.
Validate the request mode, ratio, tier, and optional controls before submission.
Qwen-Image 3.0 Pro API Parameters
Required Model
Set <code>model</code> to <code>qwen-image-3-pro</code>.
Prompt
Send a required text prompt from 1 to 2000 characters.
Aspect Ratio
Choose <code>auto</code> or one of 13 documented ratios from <code>1:1</code> through <code>8:1</code>.
Output Tier
Set <code>image_size</code> to <code>1K</code> or <code>2K</code>; the default is <code>2K</code>.
Reference Images
Optionally pass one to three URL objects in <code>image_list</code>, each under 10MB.
Prompt Controls
Optionally add a negative prompt, a seed from 0 to 2147483647, or <code>prompt_extend_mode</code>. The <code>agent</code> mode is text-to-image only.
Cost is based on the output tier plus a per-reference-image surcharge.
Qwen-Image 3.0 Pro API Pricing
1K Output
The documented price is 2.43 tokens ($0.049) per generated 1K image.
2K Output
The documented price is 4.85 tokens ($0.097) per generated 2K image. Requests with <code>ratio: auto</code> are billed at this tier.
Reference Surcharge
Each reference image adds 0.19 tokens ($0.0039). Ratios <code>1:8</code> and <code>8:1</code> are limited to—and billed at—the 1K tier.
Integrate Qwen-Image 3.0 Pro in Three Steps
1
1. Build and Validate
Choose text-to-image or reference editing, write the prompt, validate ratios and image URLs, then add your authorization header.
2
2. Submit and Persist
POST the request with
model: qwen-image-3-pro and save the returned img_uuid. 3
3. Handle Completion
Poll
GET /api/v1/jobs/detail or accept HTTPS callback events until the task succeeds or fails, then store the output or handle the error.Support both new image generation and controlled reference-based workflows.
Qwen-Image 3.0 Pro API Use Cases
Product Visuals
Generate campaign-ready scene concepts or edit approved product references into new environments.
Ad Variations
Produce prompt-led visual directions for banners, paid media, and seasonal creative testing.
Design Prototypes
Turn written art direction into image concepts before committing to full production.
Reference-Guided Restyling
Use up to three ordered references to guide composition, subject details, or visual treatment.
Localized Campaigns
Create regional scene variations while keeping the integration contract consistent.
Content Pipelines
Connect async generation to moderation, review, storage, and publishing systems in your application.
Answers about pricing, inputs, async delivery, and Alibaba API search intent.