API Free WeekHundreds of APIs are free to call this week.Browse free APIs

Qwen Image 3 Edit

alibaba/qwen-image-3/edit

Alibaba Qwen Image 3 image editing model with support for up to three reference images.

Base price
$0.04USD / run
Execution
async
Model type
image
Input fields
5
Production route

Try the model

Playground

Open playground
Input
The editing instruction describing what changes to make.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 3

List of input image URLs for editing. Supports 1 to 3 images.
The aspect ratio of the generated image. Allowed values: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16.
The format of the generated image. Allowed values: jpeg, png.
Random seed for reproducibility (0-2147483647).
OutputExample

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.04 / run

Context & modalities

Input
Schema-defined
Output
image

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
Alibaba
Model ID
alibaba/qwen-image-3/edit
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

Human preference

Arena

Elo ratings from blind side-by-side votes, compared with other image and video models.

Rankings sourced from Artificial Analysis Arena

Leaderboard
Image Editing
Rank
#23 of 69
Elo
1063 ±14
Gap to #1
−135

Image-editing arena: people pick the better of two edits of the same image and instruction, without seeing the model names.

  1. #18Qwen-Image-3.0-ProAlibaba1087±14
  2. #19Qwen-Image-2.1Alibaba1079±14
  3. #20Luma UNI 1 MaxLuma Labs1077±14
  4. #21grok-imagine-imageSpaceXAIOn SandBase1070±14
  5. #22Ideogram 4.5 (High)Ideogram1066±17
  6. #23Qwen-Image-3.0AlibabaThis model1063±14
  7. #24HunyuanImage 3.0 InstructTencent1062±14
  8. #25Seedream 5.0 LiteByteDance SeedOn SandBase1060±14
  9. #26Qwen Image 2.0 Pro (2026-04-22)Alibaba1055±19
  10. #27Nano Banana 2 Lite (Gemini 3.1 Flash Lite Image)GoogleOn SandBase1050±13

API README

Qwen Image 3 Edit

Edit up to three images with an instruction using Qwen Image 3 (Pro). It handles precise local edits, text replacement, and multi-image composition while keeping untouched areas unchanged.

Fields

FieldTypeDefaultNotes
promptstring, required—Up to 800 characters.
imagesimage URL[] (≤3), required—Images to edit, Image 1 to Image 3. The first is the main edit target.
aspect_ratio21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:163:4Output shape.
output_formatjpeg / pngpngOutput file format.
seedintegerrandomFix it to compare prompt changes.

Billing

$0.04 per output image plus $0.003 per input image, Alibaba's list price for Qwen Image 3.0 Pro.

Input imagesPrice
1$0.043
2$0.046
3$0.049

Failed runs are not charged.

Prompting

  • Say which image is the edit target and what each other image contributes.
  • List what must stay unchanged: layout, faces, printed text.
  • Quote replacement text exactly.

Limits

  • Up to 3 input images; the prompt is limited to 800 characters.

Also on SandBase

Related: alibaba/qwen-image-3/text-to-image, alibaba/qwen-image-edit/2511.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
alibaba/qwen-image-3/edit
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "alibaba/qwen-image-3/edit",
  "images": [
    "https://media.sandbase.ai/files/3b376bfd-65d4-4653-817b-51098dee1045.png"
  ],
  "prompt": "用途:precise-object-edit。图像1是唯一编辑目标。这是中国高中数学试卷批改真实性测试。\n严格保留原图的木桌、相机视角、纸张轮廓与阴影,以及全部黑色印刷文字、题号、公式、图形和版式;禁止重绘、改写、移动或删除原试卷内容。只新增以下红色教师签字笔笔迹:\n1. 在试卷右上角写“112/150”并用红笔圈住。\n2. 在四个部分标题旁依次写“45/60”“15/20”“10/20”“42/70”。\n3. 仅在第3、14、25题题号旁画红色叉号;仅在第1、13、21题题号旁画红色勾号。\n4. 在第25题旁写“计算错误”,在第22题旁写“过程不完整”。\n红笔必须像中国高中教师真实批卷:自然手写、轻微倾斜、压感和墨迹浓淡变化,位置准确且不遮挡题干。不要添加学生答案、手、人物、文具、印章、水印或其他内容。除指定红笔内容外,画面保持不变。",
  "aspect_ratio": "3:4",
  "output_format": "png"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
AlibabaImage$0.04 / runJul 21, 2026
AlibabaImage$0.04 / runJul 21, 2026
AlibabaImage$0.07 / runApr 1, 2026
AlibabaImage$0.03 / runApr 1, 2026
AlibabaImage$0.03 / runApr 1, 2026
AlibabaImage$0.07 / runApr 1, 2026

Questions

FAQ

How do I call Alibaba Qwen Image 3 Edit through SandBase?

Create a SandBase API key, then send requests with the model ID "alibaba/qwen-image-3/edit" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate Alibaba account?

No. One SandBase API key and balance gives you access to Alibaba Qwen Image 3 Edit and the other models in the catalog; you do not need to sign up with Alibaba separately.