Introduction
Qwen Image 2.1 Turbo Image Editing changes an existing image from a plain-language instruction. Alibaba's Qwen team released Turbo with open weights on 9 October 2026 and built it for continued creation through natural-language edits, from adding an accessory to changing a scene, in 8 denoising steps on the same 7B architecture as Qwen Image 2.1. One request returns 1 to 6 PNG results.
Choose a mode by what you have
| Starting material | Mode |
|---|---|
| One or more images to change | Qwen Image 2.1 Turbo Image Editing |
| A written brief and nothing else | Qwen Image 2.1 Turbo Text to Image |
Key features
Speed
26 to 59 seconds per edit end to end across our runs.
Keeps the source shape
Without an aspect ratio, a 2:3 portrait came back as a 2:3 frame at about 2K (1680 × 2512). Set an aspect ratio when you need a fixed size.
Several references in one edit
A man and a woman photographed separately came back side by side on one rooftop, both recognisable, with her outfit changed as asked.
Turbo or Qwen Image 2.1 editing
| Turbo | Qwen Image 2.1 | |
|---|---|---|
| Denoising steps | 8 | 40 |
| Results per request | 1 to 6 | 1 |
| Mask for local edits | No | Yes |
| Output format | PNG | JPEG, PNG or WebP |
Pick Qwen Image 2.1 when you need a mask.
Request parameters
| Parameter | Required | Description |
|---|---|---|
aspect_ratio | No | The shape of the frame: wide, square or tall. 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 · 2:3 · 21:9 · 9:21 · 2:1 · 1:2 · 3:1 · 1:3 · 5:4 · 4:5 |
enable_prompt_expansion | No | Lets the model add detail to a short prompt. Default: false |
enable_thinking | No | Spend extra reasoning on the rewrite for better images, at the cost of a longer wait. Only works while prompt expansion is on. Default: true |
image_urls | Yes | Photos to edit or combine. Say in the prompt what each one adds. |
num_outputs | No | How many results to make in one go. ≥ 1 · ≤ 6 · Default: 1 |
prompt | Yes | Describe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt. |
resolution | No | Output size. Bigger sizes look sharper and cost more. 1k · 1.5k · 2k · Default: 2k |
seed | No | Reuse the same number to get a repeatable result. ≥ 0 · ≤ 2147483647 |
Pricing
Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.
| Option | Credits per image | ≈ USD |
|---|---|---|
| Standard | 2.16 | $0.022 |
Each task is rounded up to whole credits, so one run at the lowest tier costs 3 credits per image ($0.03).
For an exact number before you run, send the same body to POST /jobs/quote.
Use cases
Outfit and prop changes
Swap a garment, add an accessory or change a product colour while keeping the person and the pose.
Putting people from different photos together
Pass each photo as a reference and say who goes where; the result places them in one scene.
Scene changes for one approved shot
Keep the subject and move it to a new background, season or time of day.
Prompt guide & pro tips
Change first, keep second
"Change his grey suit into a navy linen suit; keep his face, hair and expression" is an edit. "Make it better" is a reroll.
Name every reference
The model does not assign roles to references on its own. Say which image is the person, which is the garment and which is the place.
Leave expansion off
The rewrite can change your instruction before the model sees it. Off, the instruction reaches the model as written.
One change per pass
A single change is easy to judge. Five at once make it hard to tell which instruction moved the face or the hands.
Go back to the original after a few edits
Faces can drift over a long chain of edits. Return to your first approved frame when details start to move.
API quick start
Call the Qwen Image 2.1 Turbo API in three steps
- Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
- Send the request. POST /jobs/createTask with model alibaba/qwen-image-2.1-turbo/edit and an input object that follows the parameter table. The response returns a task ID straight away.
- Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-2.1-turbo/edit",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"image_urls": [
"https://media.popnow.ai/influencer/examples/marco.webp"
],
"resolution": "2k",
"num_outputs": 1
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.
Qwen Image 2.1 Turbo API questions
How much does the Qwen Image 2.1 Turbo API cost?
Qwen Image 2.1 Turbo starts at 3 credits ($0.03) per image with Edit Image, its cheapest task. Credits are the same as on the website (1 credit = $0.01), new accounts get 30 free credits, and failed tasks are refunded.
What is the model name for Qwen Image 2.1 Turbo in the API?
Put alibaba/qwen-image-2.1-turbo/text-to-image for Create Image; alibaba/qwen-image-2.1-turbo/edit for Edit Image in the model field of POST /jobs/createTask.
Why did my edit come back unchanged?
Most likely prompt expansion was on. Alibaba's rewrite can drop the part of an instruction it will not pass along, and the source then comes back almost untouched. Turn expansion off and send the same instruction again.
How fast is Qwen Image 2.1 Turbo?
Across our runs, 13 to 39 seconds for text-to-image and 26 to 59 seconds for edits, end to end. Prompt expansion and thinking mode add time when they are on.
How many images and references can one request take?
One to six output images on both endpoints, and one to ten reference images for editing. Refer to references as Image 1, Image 2 and so on in the prompt.
Can I download and run the weights myself?
Yes. The weights are on Hugging Face and ModelScope as Qwen/Qwen-Image-2.1-Turbo and load with QwenImage21Pipeline in Diffusers. They are released under the Qwen Research License Agreement, so check its terms before commercial use.
What are the limits of the Qwen Image 2.1 Turbo API?
Resolutions: 1K · 1.5K · 2K; Aspect ratios: 1:1 · 16:9 · 9:16 · 4:3 · 3:4 · 3:2 +9; Outputs per call: 1–6; Reference images: 10; Prompt length (characters): 5,000. Requests outside these limits are rejected before anything is charged.
Can I try Qwen Image 2.1 Turbo without writing code?
Yes. The Playground runs Qwen Image 2.1 Turbo on your PopNow credits, needs no API key, and shows the matching code for every run.
All Qwen Image models
Qwen Image 2.1 Pro takes the same settings and spends more on portrait lighting and fine detail. Turbo is the one for volume.
- Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
- Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image
- Qwen Image 2.1 APIOpen model with 2K output and transparent backgroundsFrom 4 credits per image
- Qwen Image 2.1 LoRA APIQwen Image 2.1 images and edits with up to three of your LoRAsFrom 5 credits per image
- Qwen Image 3.0 Pro APIFine typography plus lifelike skin, fabric and glassFrom 6 credits per image
- Qwen Image 3.0 APIReadable signs and headlines rendered into the imageFrom 5 credits per image
- Qwen Image 2 APISimple prompt-to-image and one-photo editsFrom 6 credits per image
- Qwen Image 2512 LoRA APIQwen Image 2512 renders and edits with your own LoRAsFrom 5 credits per image
- Qwen Image Edit 2509 LoRA APIMulti-photo Qwen edits that load your own LoRAsFrom 5 credits per image
- Qwen Image 1.0 LoRA APIOriginal Qwen-Image with clean lettering and your own LoRAsFrom 5 credits per image

