seedinteger
Random seed for reproducibility (0-2147483647).
Qwen Image 3 Edit
alibaba/qwen-image-3/editAlibaba Qwen Image 3 image editing model with support for up to three reference images.
Try the model
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.
Add at least one media item.
Additional Settings More
Customize your input with more control.
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).
ResultExample
What would you like to do next?
Examples
Select an example to load its inputs and result into the playground.
- Open result ↗
Input
{ "aspect_ratio": "1:1", "images": [ "https://static.sandbase.ai/examples/f17ae866-160b-49bb-aae6-735643de913f/input/343ea4a5-3866-4623-9a00-49b64ad429a8.png" ], "prompt": "Make the sky orange at sunset" }
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
- #30 of 77
- Elo
- 1068 ±13
- Gap to #1
- −131
Image-editing arena: people pick the better of two edits of the same image and instruction, without seeing the model names.
- #25Luma UNI 1 Max1079±13
- #26grok-imagine-image1073±13
- #27FLUX 3 Image Klein1072±14
- #28Ideogram 4.5 (High)1070±15
- #29Qwen-Image-2.1-Pro1069±13
- #30Qwen-Image-3.01068±13
- #31Qwen-Image-2.1-Turbo1064±14
- #32HunyuanImage 3.0 Instruct1063±13
- #33Seedream 5.0 Lite1062±13
- #34Qwen Image 2.0 Pro (2026-04-22)1058±17
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
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Up to 800 characters. |
images | image URL[] (≤3), required | — | Images to edit, Image 1 to Image 3. The first is the main edit target. |
aspect_ratio | 21:9 / 16:9 / 3:2 / 4:3 / 5:4 / 1:1 / 4:5 / 3:4 / 2:3 / 9:16 | 3:4 | Output shape. |
output_format | jpeg / png | png | Output file format. |
seed | integer | random | Fix 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 images | Price |
|---|---|
| 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
Submit this model through the SandBase Unified Run API.
# 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"2. Authentication
Create a SandBase API key and set it in your server environment. All requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep the key on your server. Do not expose it in browser code or commit it to a repository.
3. Queue
Submit a request
POST to /v1/run with this model ID and its inputs. The request example above includes submission and polling.
Fetch request status and result
Use the returned run ID to poll until the status is completed, failed or timeout. Read output only after completed.
curl "https://api.sandbase.ai/v1/run/$RUN_ID" \
-H "Authorization: Bearer $SANDBASE_API_KEY"4. Files
Hosted files
Pass a publicly accessible file URL in the model’s image, video or audio field. Supported formats and limits are shown beside each Playground input.
Uploading images
Use the upload or replace control on supported image fields in the Playground. Video URL fields accept a hosted driving video; they do not imply video-upload support.
5. Schema
Input
imagesarrayrequired
List of input image URLs for editing. Supports 1 to 3 images.
promptstringrequired
The editing instruction describing what changes to make.
Default: "用途：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_ratiostring
The aspect ratio of the generated image.
Default: "3:4"
Possible values: "21:9", "16:9", "3:2", "4:3", "5:4", "1:1", "4:5", "3:4", "2:3", "9:16"
output_formatstring
The format of the generated image.
Default: "png"
Possible values: "jpeg", "png"
{
"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"
}Output
A completed run exposes its result in output. The following is the model’s saved example, not a new generation.
[
{
"source": "Self organization completed prediction",
"source_url": "https://www.sandbase.ai",
"url": "https://static.sandbase.ai/examples/f17ae866-160b-49bb-aae6-735643de913f/output/96abab89-e9ea-4462-a616-b1e229b0f7a5.png"
}
]