Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
No image yet. Submit the form to generate image.
Explore different use cases and parameter configurations
Transparent pricing with no hidden fees. Pay as you go.
| Rule & Modality | Channel | Credits | Price (USD) | Official / Reference Price | Daily Savings |
|---|---|---|---|---|---|
test imageQwen | Regular | 999per run | $4.541 | - | - |
Complete guide to using qwen-image-2-1
Build with Qwen-Image-2.1 on ApiPass for text-to-image generation, image-to-image editing, transparent assets, multi-reference workflows, and local edits through one developer-friendly API. Qwen Image 2.1 is a compact, efficient image model designed for high-quality creative and production workflows.
Qwen Image 2.1 is Alibaba’s compact AI image model for unified image generation and editing. It supports text-to-image creation, reference-based image editing, native transparent-background outputs, multi-reference composition with up to 10 images, mask-based local editing, and improved fidelity for people, products, and text. Through ApiPass, developers use one model name, qwen/qwen-image-2-1, while the adapter automatically selects the text-to-image route when no reference image is provided and the image-to-image route when image_urls contains images.
Generate polished visuals from natural language prompts. Qwen Image 2.1 can create portraits, product visuals, illustrations, marketing graphics, social content, posters, and other creative assets with strong detail and aesthetics.
Transform existing images using text instructions. Change objects, clothing, expressions, backgrounds, styles, and scene details while preserving the visual structure of the source image when possible.
Use up to 10 reference images for multi-asset composition, virtual try-on, product arrangement, or scene building. For targeted changes, provide a mask_url with exactly one reference image and regenerate only the white masked area.
Create detailed visuals at 1K or native 2K resolution across multiple aspect ratios. 2K generation is ideal for product visuals, marketing assets, posters, social content, and production-ready creative workflows.
Generate transparent visual assets directly without relying on a separate background-removal step. Transparent background outputs use PNG or WebP with alpha and cannot be combined with JPEG/JPG output.
Create one coherent result from multiple visual inputs. Combine people into group photos, match clothing and accessories, arrange products, or build interior scenes from separate assets.
Use mask_url to control where edits happen. White mask areas are regenerated while black areas remain unchanged. Mask editing must be used with exactly one reference image and cannot be combined with transparent background.
Qwen Image 2.1 improves identity consistency for portraits, preserves defining product details, and handles text-heavy designs such as posters, advertisements, infographics, and social graphics more effectively.
Build text-to-image products that let users create portraits, illustrations, concept art, marketing visuals, and social content from natural language prompts.
Create image editors where users can change objects, backgrounds, clothing, expressions, styles, or selected regions with simple text instructions.
Generate campaign visuals, update product backgrounds, create catalog content, and preserve important product details such as shape, texture, and text across edits.
Use multi-reference input to combine a person with clothing, shoes, bags, hats, or accessories into a unified fashion visual for shopping and styling experiences.
Create transparent PNG or WebP assets for products, stickers, design elements, and reusable creative content directly from prompts or source images.
ApiPass provides a developer-friendly way to access Qwen Image 2.1 without managing model hosting, GPU infrastructure, or separate upstream routes.
Use qwen/qwen-image-2-1 for both text-to-image and image-to-image workflows. ApiPass automatically routes requests based on whether image_urls contains reference images.
Create a task with /api/v1/jobs/createTask, then query progress and results with /api/v1/jobs/recordInfo using the returned taskId. If callBackUrl is provided, ApiPass posts completion notifications to your endpoint.
Use the optional channel parameter to choose auto, starter, regular, or official routing. auto lets ApiPass allocate tasks across available providers based on real-time pricing and stability.
Qwen Image 2.1 supports 1K and 2K output resolution tiers. 2K can produce more detailed images but may take longer to generate than 1K.
ApiPass is designed to provide flexible, cost-conscious access to image generation APIs so teams can test ideas and scale production workloads without managing expensive infrastructure.
New users can use free credits to test prompts, image inputs, editing workflows, transparent backgrounds, and result quality before moving into production.
Use the ApiPass Playground to test prompts, upload supported reference images, compare generation and editing workflows, and inspect the resulting images directly in your browser.
Create an ApiPass API key for authentication. Use it with the Authorization: Bearer YOUR_API_KEY header when calling the Qwen Image 2.1 endpoints.
Send a POST request to /api/v1/jobs/createTask with model qwen/qwen-image-2-1 and an input object containing prompt, optional image_urls, mask_url, aspect_ratio, resolution, background, output_format, enhance_prompt, and seed.
Use the returned taskId to query /api/v1/jobs/recordInfo. For asynchronous integrations, provide callBackUrl when creating the task and ApiPass will notify your endpoint when the task reaches a terminal state.
All APIs require authentication via Bearer Token.
Authorization: Bearer
Submit a new Qwen Image 2.1 text-to-image or image-to-image generation task
The API accepts a JSON payload with the following structure:
1{
2 "model": "qwen/qwen-image-2-1",
3 "callBackUrl": "string (optional)",
4 "channel": "auto",
5 "input": {
6 "prompt": "string",
7 "image_urls": ["string"],
8 "mask_url": "string",
9 "aspect_ratio": "string",
10 "resolution": "string",
11 "background": "string",
12 "output_format": "string",
13 "enhance_prompt": true,
14 "seed": 0
15 }
16}modelRequiredstringThe model name to use for generation.
"qwen/qwen-image-2-1"
callBackUrlOptionalstringCallback URL for task completion notifications. If omitted, no callback will be sent.
"https://your-domain.com/api/callback"
channelOptionalstringOptional APIPASS provider routing channel. The default channel is auto; APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics. starter is ultra-low-cost with limited quotas and weaker stability. regular is standard and much cheaper than official APIs with moderate stability. official uses the model native API with high stability, fast task execution, and official pricing.
The default channel is auto. APIPASS automatically allocates tasks across available providers based on real-time pricing and stability metrics. starter is ultra-low-cost with limited quotas and weaker stability; regular is standard and much cheaper than official APIs with moderate stability; official uses the model native API with high stability, fast task execution, and official pricing.
Available options:
auto
The input object contains the following parameters:
input.promptRequiredstringText prompt for text-to-image generation or image editing. Maximum length: 5000 characters.
Describe the subject, style, lighting, composition, and editing target. The prompt can be used for both text-to-image generation and image editing.
"A cinematic mountain lake at sunrise with mist and reflective water"
input.image_urlsOptionalarray(URL)Reference image URLs. Supports 1 to 10 images. Supported formats: JPEG, PNG, and WebP. Maximum size: 30 MB and 25 MP per image.
When this list is non-empty, the adapter automatically uses the upstream image-to-image route. Compatible aliases are accepted for legacy integrations, but new calls should use image_urls.
["https://example.com/reference.png"]
input.mask_urlOptionalstringOptional mask URL for local image editing. White areas indicate the generation area.
Use a white mask region to indicate the area to regenerate. This parameter is only valid with exactly one reference image and cannot be used with transparent background.
"https://example.com/mask.png"
input.aspect_ratioOptionalstringAspect ratio of the generated image.
For text-to-image requests, the default is 3:2. For image-to-image requests, the default is auto. auto only applies when a reference image is provided, and this parameter is ignored during mask-based local editing.
Available options:
"16:9"
input.resolutionOptionalstringResolution of the generated image. Default: 1K.
2K generation may take longer than 1K.
Available options:
"1K"
input.backgroundOptionalstringBackground mode for the output image. Default: opaque.
Transparent background outputs an image with alpha in PNG/WebP format and cannot be combined with jpeg or jpg output.
Available options:
"opaque"
input.output_formatOptionalstringOutput image format. Default: png.
jpg is accepted and normalized to jpeg. jpeg cannot be combined with transparent background.
Available options:
"png"
input.enhance_promptOptionalbooleanWhether to rewrite the prompt into a more complete scene description before generation. Default: true.
true
input.seedOptionalnumberRandom seed used to reproduce the same result when the model version, prompt, and parameters are unchanged. Default: 0.
0
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "qwen/qwen-image-2-1",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "channel": "auto",
8 "input": {
9 "prompt": "A cinematic mountain lake at sunrise with mist and reflective water",
10 "aspect_ratio": "16:9",
11 "resolution": "1K",
12 "background": "opaque",
13 "output_format": "png",
14 "enhance_prompt": true,
15 "seed": 0
16 }
17 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_12345678"
6 }
7}codeStatus code, 200 for success, others for failure
messageResponse message, error description when failed
data.taskIdTask ID for querying task status and results
flux
flux
Generate photorealistic images with robust text
Starting from
0 credits
Nano Banana 2 Lite, aka Gemini 3.1 Flash-Lite Image, is a newly released image model from Google DeepMind built for fast 1K image generation, efficient creative iteration, prompt-based image editing, and responsive visual output in product-facing creative scenarios.
Starting from
0 credits
OpenAI
OpenAI
Generate intentionally designed visuals with less prompting using the latest OpenAI GPT Image 2 model.
Starting from
0 credits
Nano Banana now allows you to freely draw on edited images, bringing you a completely new experience. Simply click on the image to draw whatever you want. You can also add text and details, and Gemini will do the rest.
Starting from
0 credits
Fast image generation model built on Gemini 3.1 Flash Image. Supports text-to-image, image editing, multi-image fusion with up to 14 reference images, Google Search grounding, and outputs up to 4K resolution.
Starting from
0 credits
seedream
seedream
Starting from
0 credits
grok
grok
Grok Imagine is xAI’s AI video generation model for creating high-quality videos with realistic motion, native audio, and synchronized speech. Grok Imagine 1.5 introduces faster generation speeds, improved motion physics, and stronger visual consistency for modern AI video applications.
Starting from
0 credits
qwen
qwen
Generate realistic 2K images with structured text
Starting from
0 credits
seedream
seedream
Starting from
0 credits
OpenAI
OpenAI
Bring your ideas to life with sharper, faster, more precise image generation using the GPT Image 2.5 API.
Starting from
0 credits
wan
wan
Generate images with cinematic precision through high-fidelity text-to-image synthesis and structural editing.
Starting from
0 credits
seedream
seedream
Gemini said Generate images with lightning-fast efficiency and high-fidelity detail through a streamlined, lightweight architecture optimized for instant creative expression.
Starting from
0 creditsqwen
qwen
Generate realistic 2K images with structured text
Starting from
0 credits
Luma
Luma
Starting from
0 credits
seedream
seedream
Starting from
0 credits