Qwen Image 2.1 Text To Image
Qwen Image 2.1 is a 7B-parameter image generation model with native 2K resolution (2048x2048). It supports both text-to-image and image-to-image with up to 10 reference images, featuring 40-step inference for high-quality output and 7 aspect ratio options.
Key Features
- Native 2K resolution — generates images at 2048×2048 and other 2K-class sizes without upscaling.
- 7B-parameter model — a powerful image generation backbone with strong prompt understanding.
- 40-step inference — high-quality output with detailed textures and accurate compositions.
- 7 aspect ratio options — 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16 with 32-pixel-aligned dimensions.
- RGBA output — native transparency support for compositing workflows.
- Bilingual prompt support — understands prompts in English and Chinese.
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Natural-language description of the image to generate. |
| aspect_ratio | No | Aspect ratio: 1:1 (default), 4:3, 3:4, 3:2, 2:3, 16:9, 9:16. |
How to Use
- Provide a detailed prompt describing the desired image — subject, style, lighting, composition.
- Select an aspect ratio from the 7 available options to match your output needs.
- All outputs are generated at native 2K resolution — no additional resolution setting needed.
- Use detailed prompts for best results; the model excels with specific scene descriptions.
Code Examples
import os
import requests
response = requests.post(
"https://aircube.ai/api/v3/qwen-image-2.1/text-to-image",
headers={
"Authorization": "Bearer " + os.environ["AIRCUBE_API_KEY"],
"Content-Type": "application/json",
},
json={
"prompt": "A cinematic shot of a mountain lake at golden hour, with snow-capped peaks reflected in crystal-clear water",
"aspect_ratio": "16:9"
},
timeout=300,
)
data = response.json()
if data["success"]:
print("ID:", data["data"]["id"], "Status:", data["data"]["status"])
else:
print("Error:", data["error"]["message"])Pricing
| Resolution | Duration | Cost |
|---|---|---|
| 2k | per image | $0.03 |
Billing rules
- Per image: 2k: $0.03.
- Failed generations are not charged.
Best Use Cases
- High-resolution content creation — generate 2K images directly without upscaling artifacts.
- Marketing and advertising — hero images, banners, and social media visuals at production resolution.
- Product visualization — detailed product renders and concept images.
- Illustration and concept art — leverage the 7B model's strong compositional understanding.
- Print-ready assets — 2K output is suitable for many print applications.
- Transparent backgrounds — use RGBA output for compositing into existing designs.
Pro Tips
- Include detailed style and lighting descriptions for best results.
- The model outputs at 2K natively — no need to specify resolution.
- Take advantage of bilingual support — prompts in Chinese produce equally high-quality output.
- For wide compositions, use 16:9 ratio (2752×1536); for tall compositions, use 9:16 (1536×2752).
- Combine with image-to-image mode to iterate on generated concepts using reference images.
Notes
- Fixed 2K output resolution — all aspect ratios produce 2K-class pixel dimensions.
- 7 aspect ratio options available; all dimensions are aligned to 32-pixel boundaries.
- 40-step inference pipeline for high-quality output.


