Qwen Image 3.0
Qwen Image 3.0 Image Generation
- Asynchronous processing mode, returns a task ID for subsequent queries
- Supports text-to-image and image-to-image (1-3 reference images for editing)
- Supports 1K / 2K resolution, up to 6 images per request
- Standard and Pro variants (Pro is stronger for dense layout and text)
POST
Supported Models
Authorizations
string
required
Body
string
required
Model name
qwen-image-3.0- Standardqwen-image-3.0-pro- Pro (dense text / layout)
string
required
Text description for image generation, max ~4.5k tokens
string[]
Reference image URL array (image-to-image / editing), 1-3 images
- Public
http(s)://URL ordata:image/png;base64,...(base64 is re-uploaded first) - Formats: JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF
- Per file ≤ 10MB; width/height recommended 384-2048 px
string
default:"1K"
Resolution tier (affects billing tier)
1K(default; lowercase accepted)2K
size (e.g. 1600x900). With raw pixels, area > 2.25M pixels bills as 2K.string
default:"1:1"
Aspect ratio, or explicit pixel sizeSupported ratios:
1:1(default)4:3/3:416:9/9:163:2/2:3
16x9 style, or pixels like 1024x1024. For custom pixels, each edge (width and height) must be 512–2048, aspect ratio 1:8 ~ 8:1.If neither size nor resolution is set, output is fixed at 1024×1024.integer
default:"1"
Number of images, 1-6. Values above 6 are clamped to 6.
string
Negative prompt: content to avoid
boolean
default:"false"
Intelligent prompt rewritingDefaults to off for predictable results. Set to
true to enable intelligent rewriting.string
Rewrite mode (3.0 series only; requires
prompt_extend: true)direct- works for text-to-image and image-to-imageagent- text-to-image only, more aggressive rewrite
Size Reference Table
Combineresolution (tier) + size (ratio):
Use Cases
Text-to-image (multiple)
Dense layout with rewrite
Image-to-image (edit)
Negative prompt
Limits
Response
integer
Status code; 200 on success
array
Response data array
Differences from 2.0
Notes
- Async: Submit returns a
task_id. Poll Get Task Status every 3~5 seconds; client timeout ~3 minutes (2K + multi-image is slower). - Storage: Generated images are mirrored to the platform CDN and remain available long-term.
- Billing: Per delivered image × resolution tier by actual pixel area (> 2.25M pixels = 2K).
qwen-image-3.0charges the same for 1K/2K;-pro2K is 2× 1K. Failures are fully refunded; reference images are free. - Errors: Custom
sizeedge outside 512–2048, invalid ratio,agenton image-to-image, unreachable/oversized references → 400; rate limit → 429.
Query resultsUse Get Task Status for progress and
result.images.