Qwen Image 2.1 Pro Edit

alibaba/qwen-image-2.1-pro/edit

Edit images with a prompt and 1–10 reference images; generate 1–6 output images.

Examples

Qwen Image 2.1 Pro Edit Examples 1

Parameters

NameTypeDefaultConstraintsDescription
prompt *Prompttextarea—≤ 5000 charsText prompt describing the desired edit, supports Chinese and English; up to about 4500 tokens is recommended. Negative prompts are not supported, so state anything to avoid directly in the prompt (e.g. "no text"). Ask for a cutout or transparent background and the model outputs a PNG with an alpha channel.
images *Reference Imagesimage_upload—image/jpeg,image/jpg,image/png,image/bmp,image/tiff,image/webp,image/gif · 1–10 itemsReference images for editing, 1-10 images. Up to 10MB each, 1-8000px per side (384-2048px recommended), aspect ratio up to 10:1. Order defines image 1, image 2 ... image 10 in the prompt.
nNumber of Imagesnumber11 ~ 6 · step 1Generate 1-6 images per request, billed per successfully generated image
sizeSizetext—≤ 16 charsOutput size in width*height format. Total pixels from 512*512 to 2048*2048, aspect ratio between 1:8 and 8:1. Recommended: 2048*2048 (1:1), 2688*1536 (16:9), 1536*2688 (9:16), 2368*1728 (4:3), 1728*2368 (3:4). Leave empty to let the model auto-select.
prompt_extendPrompt Extendbooleantrue—Automatically expands and optimizes the prompt. Recommended; most useful for short prompts.
enable_thinkingThinking Modebooleantrue—Enhances reasoning to improve image quality at the cost of longer generation time. Only takes effect when Prompt Extend is on.
seedSeednumber—0 ~ 2147483647 · step 1For reproducibility, 0-2147483647. Leave empty for random.

Output fields

FieldTypeDescription
imagesarray<string>

API

Call this model through one unified REST API. Get a key on the API Keys page.

cURL
# 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"
Python
import time, requests

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1) Submit
resp = requests.post(
    "https://www.namifusion.com/api/v1/marketplace/run/alibaba/qwen-image-2.1-pro/edit",
    headers=HEADERS,
    json={
        "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
        }
    },
)
resp.raise_for_status()  # 401/402/429/5xx stop here instead of polling a bad task
task = resp.json()

# 2) Poll until a terminal state (completed / failed / cancelled).
#    This model is allowed up to 1800s server-side.
deadline = time.time() + 1860
while task.get("status") not in ("completed", "failed", "cancelled"):
    if time.time() > deadline:
        raise TimeoutError(f"still {task.get('status')} — keep the task_uuid and poll later")
    time.sleep(3)
    poll = requests.get(f"https://www.namifusion.com/api/v1/marketplace/run/tasks/{task['task_uuid']}", headers=HEADERS)
    poll.raise_for_status()
    task = poll.json()

print(task["status"], task.get("output"))
JavaScript
const API_KEY = "YOUR_API_KEY";
const HEADERS = { Authorization: `Bearer ${API_KEY}` };

// 1) Submit
const resp = await fetch("https://www.namifusion.com/api/v1/marketplace/run/alibaba/qwen-image-2.1-pro/edit", {
  method: "POST",
  headers: { ...HEADERS, "Content-Type": "application/json" },
  body: JSON.stringify({
    "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
    }
  }),
});
if (!resp.ok) throw new Error(`submit failed: ${resp.status} ${await resp.text()}`);
let task = await resp.json();

// 2) Poll until a terminal state (completed / failed / cancelled).
//    This model is allowed up to 1800s server-side.
const deadline = Date.now() + 1860 * 1000;
while (!["completed", "failed", "cancelled"].includes(task.status)) {
  if (Date.now() > deadline) throw new Error(`still ${task.status} — keep the task_uuid and poll later`);
  await new Promise((r) => setTimeout(r, 3000));
  const poll = await fetch(`https://www.namifusion.com/api/v1/marketplace/run/tasks/${task.task_uuid}`, { headers: HEADERS });
  if (!poll.ok) throw new Error(`poll failed: ${poll.status}`);
  task = await poll.json();
}

console.log(task.status, task.output);

Documentation

Qwen Image 2.1 Pro Edit

alibaba/qwen-image-2.1-pro/edit

Edit images with a prompt and 1–10 reference images; generate 1–6 output images.

Parameters

ParameterTypeRequiredDefaultDescription
promptstringtrue—Text prompt describing the desired edit, supports Chinese and English; up to about 4500 tokens is recommended. Negative prompts are not supported, so state anything to avoid directly in the prompt (e.g. "no text"). Ask for a cutout or transparent background and the model outputs a PNG with an alpha channel.; max 5000 characters
imagesarraytrue—Reference images for editing, 1-10 images. Up to 10MB each, 1-8000px per side (384-2048px recommended), aspect ratio up to 10:1. Order defines image 1, image 2 ... image 10 in the prompt.; 1–10 URLs
nintegerfalse1Generate 1-6 images per request, billed per successfully generated image [1, 6]
sizestringfalse—Output size in widthheight format. Total pixels from 512512 to 20482048, aspect ratio between 1:8 and 8:1. Recommended: 20482048 (1:1), 26881536 (16:9), 15362688 (9:16), 23681728 (4:3), 17282368 (3:4). Leave empty to let the model auto-select.; max 16 characters
prompt_extendbooleanfalsetrueAutomatically expands and optimizes the prompt. Recommended; most useful for short prompts.
enable_thinkingbooleanfalsetrueEnhances reasoning to improve image quality at the cost of longer generation time. Only takes effect when Prompt Extend is on.
seedintegerfalse—For reproducibility, 0-2147483647. Leave empty for random. [0, 2.14748e+09]

Pricing

$0.04 per successfully generated image (4 credits). Precharge = unit price × requested n; settlement uses the actual successful output image count. Input reference images, output size and prompt expansion add no charge. Default n=1.

size uses width*height; total pixels 512²–2048², aspect ratio 1:8–8:1. Omit size for automatic selection. Omit seed for random generation. enable_thinking only applies when prompt_extend=true.

Alibaba International standard USD list prices. USD 1 = 100 credits. Account discounts are applied separately.

API

curl -X POST https://www.namifusion.com/api/v1/marketplace/run/alibaba/qwen-image-2.1-pro/edit \
  -H "Authorization: Bearer $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "input": {
    "n": 1,
    "seed": 12345,
    "size": "2048*2048",
    "images": [
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/261013/default/254gkbbtuykh.jpeg",
      "https://d1s3annbwribom.cloudfront.net/marketplace/examples/261013/default/5f4s804daar9.jpeg"
    ],
    "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.",
    "prompt_extend": true,
    "enable_thinking": true
  }
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
  -H "Authorization: Bearer $API_KEY"

Poll task_uuid until completed or failed. On success, output.images contains output URL strings.

Alibaba official pricing

Related models

xAI Grok Imagine Image v2.0 Edit
Image to ImageX Ai

xAI Grok Imagine Image v2.0 Edit

xAI Grok Imagine Image V2.0 Edit transforms input images with text prompts, with configurable resolution and quality for precise image editing, visual refinements, creative variations, social content, marketing assets, and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.090 / per run
qwen-image-edit-spicy
Image to Image

qwen-image-edit-spicy

Precisely edit images with text instructions. Add, remove, or modify visual elements, transfer styles, and replace backgrounds for photo retouching and visual design.

from $0.034 / per run
Qwen Image 3.0 Pro Edit | Fast Image Editing
Image to ImageQwen Image 3.0 Pro

Qwen Image 3.0 Pro Edit | Fast Image Editing

Qwen Image 3.0 Pro Edit is a professional-grade image editing model with superior quality and advanced instruction understanding. Up to 2k. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

from $0.0663 / per run
OpenAI GPT Image 2.5 Sunburst Edit
Image to ImageOpenAI

OpenAI GPT Image 2.5 Sunburst Edit

High-fidelity image editing for precise transformations using up to 16 reference images.

from $0.220 / per run
OpenAI GPT Image 2.5 Flare Edit
Image to ImageOpenAI

OpenAI GPT Image 2.5 Flare Edit

Fast, balanced image editing from natural-language instructions and up to 16 reference images.

from $0.220 / per run
Image to Image
Image to ImageNamiFusion

Head Swap (Image)

Swap the head in a photo with the head from a reference image. Upload the target photo first, then the head reference.

from $0.220 / per run
Nano Banana Image Edit
Image to ImageGoogle

Nano Banana Image Edit

Fast & Affordable Editing. Intuitive object replacement and style transfer without manual masking.

from $0.038 / per run
Nano Banana Pro Image Edit
Image to ImageGoogle

Nano Banana Pro Image Edit

4K Semantic Editing.Modifies existing images via natural language with context awareness and multilingual text editing.

from $0.140 / per run