alibaba/qwen-image-3/edit
Alibaba Qwen Image 3 image editing model with support for up to three reference images.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 3
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runalibaba/qwen-image-3/editInput Schema
5 parameters · 2 required · 3 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
images | string[] | Required | List of input image URLs for editing. Supports 1 to 3 images. |
prompt | string | Required | The editing instruction describing what changes to make. · Min length: 1 · Max length: 800 · 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红笔必须像中国高中教师真实批卷：自然手写、轻微倾斜、压感和墨迹浓淡变化，位置准确且不遮挡题干。不要添加学生答案、手、人物、文具、印章、水印或其他内容。除指定红笔内容外，画面保持不变。" |
seed | integer | Optional | Random seed for reproducibility (0-2147483647). · Default: 20260724 |
aspect_ratio | string | Optional | The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 · Default: "3:4" 21:916:93:24:35:41:14:53:42:39:16 |
output_format | string | Optional | The format of the generated image. · Options: jpeg, png · Default: "png" jpegpng |
Output Schema
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier for the generation task |
status | string | Task status: pending, running, completed, failed, timeout |
model | string | Model used for the generation |
outputs | array | Array of output items |
outputs[].url | string | URL of the generated artifact |
outputs[].content_type | string | MIME type (e.g. image/png, video/mp4) |
error | object | null | Error details if failed, null on success |
error.type | string | Machine-readable error type code |
error.message | string | Human-readable error description |
Async Workflow
This model uses asynchronous execution. Submit a request and poll for the result.
- Submit — POST to /v1/run, receive an
id - Poll — GET /v1/run/{id} until status is
completed,failed, ortimeout - Retrieve — Read
outputsfrom the completed response
Code Examples
Ready-to-run snippets
# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "alibaba/qwen-image-3/edit",
"seed": 20260724,
"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"
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
Qwen Image 3 Edit
Qwen Image 3 Edit is an image-editing model for applying precise written changes to one or more supplied visuals. It is designed to understand both the content of the reference and the requested transformation, so subjects, layout, style, and textual elements can be revised without rebuilding the entire image from scratch.
The model is useful for product variations, poster updates, localized typography, scene restyling, object-level changes, and iterative art direction. State what must change and what must remain fixed; concrete wording about position, scale, lighting, color, and text placement gives the editing process a clearer target.
Highlights
- Instruction-driven image editing. Applies a written transformation while the source image continues to anchor the result.
- Complex layout understanding. Handles compositions with several regions, subjects, or design elements that must remain coordinated.
- Small and multilingual text. Supports detailed typography-oriented edits, including compact text and multiple writing systems.
- Photographic detail preservation. Retains fine visual structure while changing selected content, style, or presentation.
Pricing
| Charge | Billing unit | Price |
|---|---|---|
| Base edit request | Per request | $0.042 |
| Reference-image processing | Per supplied image | $0.00315 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs revising an existing visual asset | The goal is a different media task or endpoint |
| The available inputs match the required local schema | Required source media or permissions are unavailable |
| The brief can specify subject, composition, style, and delivery | The result must be deterministic at pixel or sample level |
| The supported formats and controls match final placement | Delivery requires unsupported dimensions, codecs, or duration |
| An asynchronous generated result fits the workflow | A live, frame-synchronous, or real-time response is mandatory |
Prompt Guide
Write the request as a production brief: identify the main subject or source material, state the intended transformation, describe composition or timing, and finish with style, atmosphere, and delivery constraints. Keep preservation requirements separate from requested changes, and use only fields exposed by this route.
{
"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红笔必须像中国高中教师真实批卷：自然手写、轻微倾斜、压感和墨迹浓淡变化，位置准确且不遮挡题干。不要添加学生答案、手、人物、文具、印章、水印或其他内容。除指定红笔内容外，画面保持不变。",
"images": [
"https://example.com/reference.jpg"
],
"seed": 20260724,
"aspect_ratio": "21:9",
"output_format": "jpeg"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | alibaba/qwen-image-3/edit |
| Input fields | seed (integer)<br>images (array)<br>prompt (string)<br>aspect_ratio (string; 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16)<br>output_format (string; jpeg, png) |
| Required input | prompt, images |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
alibaba/happy-horse/video-editalibaba/wan/2.2/image-to-video/turboalibaba/wan/2.1/text-to-video