alibaba/qwen-image-2.1-turbo/editFrom 3 credits per image· Edit Image

Qwen Image 2.1 Turbo image editing changes a picture from a plain-language instruction in 8 denoising steps.

Call it with the model name alibaba/qwen-image-2.1-turbo/edit on POST /jobs/createTask, from 3 credits per image ($0.03). New accounts get 30 free credits to try it in the Playground first.

  • Create Image
  • Edit Image
  • Up to 2K
  • Up to 10 reference images
  • 15 aspect ratios
  • Up to 6 per run

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 materialMode
One or more images to changeQwen Image 2.1 Turbo Image Editing
A written brief and nothing elseQwen 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

TurboQwen Image 2.1
Denoising steps840
Results per request1 to 61
Mask for local editsNoYes
Output formatPNGJPEG, PNG or WebP

Pick Qwen Image 2.1 when you need a mask.

Request parameters

ParameterRequiredDescription
aspect_ratioNoThe 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_expansionNoLets the model add detail to a short prompt. Default: false
enable_thinkingNoSpend 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_urlsYesPhotos to edit or combine. Say in the prompt what each one adds.
num_outputsNoHow many results to make in one go. ≥ 1 · ≤ 6 · Default: 1
promptYesDescribe the subject, composition, lighting, and any wording to render. There is no negative prompt: write what to leave out directly in the prompt.
resolutionNoOutput size. Bigger sizes look sharper and cost more. 1k · 1.5k · 2k · Default: 2k
seedNoReuse 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.

OptionCredits per image≈ USD
Standard2.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

  1. 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.
  2. 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.
  3. 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.

More about Qwen Image 2.1 Turbo