How to Use the Qwen Image 2.1 Pro Edit API: image to image integration guide (2026)

Qwen Image 2.1 Pro Edit is an image to image model by Alibaba: Edit images with a prompt and 1–10 reference images; generate 1–6 output images. On NamiFusion you can try it in the playground (exact quote shown before you submit), then call it through one unified REST API — about $0.040 per typical run.

TL;DR

· Task type: image to image, provided by Alibaba

· Pricing: about $0.040 per typical run ($1 = 100 credits), pay-as-you-go

· Getting started: playground (exact quote before submit) → create an API key → one POST request

· Tunable parameters: 7 (see the table below)

· No platform watermark; commercial use allowed (per the Terms of Service)

What can you build with Qwen Image 2.1 Pro Edit?

Social media visuals and covers: batch-generate on-theme images and schedule them straight away.

E-commerce and ad creatives: product scenes, banner backgrounds, and multi-variant visuals for A/B tests.

Concept art and ideation: characters, environments and style boards, iterated cheaply and fast.

Pipeline chaining: outputs feed directly into image-to-video or face swap as source material.

How do you call this API?

1. Sign up on NamiFusion and create a key on the API Keys page (signup bonus credits can only be used on selected models).
2. Submit a task with the cURL example below, passing your key as a Bearer token.
3. Poll the task status with the returned task_uuid and read the output URLs when completed.

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/alibaba/qwen-image-2.1-pro/edit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "Using image 1 as the main product reference and image 2 as the lifestyle scene reference, create a clean premium e-commerce hero image of the same leather handbag placed on a light beige stone pedestal in soft natural studio lighting. Keep the bag'\''s exact shape, color, stitching, hardware, and proportions consistent with the reference. Replace the background with a minimal warm neutral setting, add a subtle soft shadow under the bag, and remove any distracting props. No text, no watermark, no extra bags, no people, no logo changes.",
    "images": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/261013/default/254gkbbtuykh.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/261013/default/5f4s804daar9.jpeg"
    ],
    "n": 1,
    "size": "2048*2048",
    "prompt_extend": true,
    "enable_thinking": true,
    "seed": 12345
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

What parameters does it take?

prompt (Prompt): required

images (Reference Images): required

n (Number of Images): optional, default 1

size (Size): optional

prompt_extend (Prompt Extend): optional, default true

enable_thinking (Thinking Mode): optional, default true

seed (Seed): optional

How do you write prompts for Qwen Image 2.1 Pro Edit?

1. Subject first: lead with the actor and action, then add environment, lighting and style ("an astronaut sprinting through a neon street in the rain, cinematic, shallow depth of field").
2. Concrete nouns beat stacked adjectives: "85mm portrait lens, golden-hour backlight" works far better than "very beautiful, ultra high quality".
3. Change one variable per iteration: pin the seed to reproduce a result, tweak a single phrase at a time so you know what actually moved the output.
4. State negatives positively: instead of "no blur", ask for "sharp focus, crisp details".

How much does it cost?

Pay-per-use in credits. About $0.040 per typical run ($1 = 100 credits); the exact price varies with parameters like resolution or duration, and the playground shows the exact quote before you submit.