alibaba/qwen-image/edit
Qwen Image Edit is Alibaba's intelligent image editing model. Transform, retouch, and reimagine existing images using text prompts - from background replacement to artistic style conversion.
PNG, JPEG, WebP, or GIF · 20 MiB maximum
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/editInput Schema
7 parameters · 2 required · 5 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | The reference image to guide the generation. |
prompt | string | Required | The prompt to generate the image with |
seed | integer | Optional | The same seed and the same prompt given to the same version of the model will output the same image every time. |
strength | number | Optional | Denoising strength. 1.0 = fully remake; 0.0 = preserve original. · Min: 0 · Max: 1 · Default: 0.6 |
use_turbo | boolean | Optional | Enable turbo mode for faster generation with high quality. When enabled, uses optimized settings (10 steps, CFG=1.2). · Default: false |
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 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/edit",
"image": "https://static.sandbase.ai/examples/alibaba/qwen-image/edit/input_image_0.png",
"prompt": "Mount Fuji with purple japanese wisteria in the foreground, clear sky, peaceful spring day, soft natural light, landscape, painted with oil brush on a wood panel with abstract mixed colors",
"strength": 0.8,
"use_turbo": true,
"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 Edit
Qwen Image Edit is the Qwen Image route for instruction-driven image revision. It uses Qwen’s combined visual-semantic and appearance modeling to interpret subjects, relationships, typography, spatial structure, and surface detail as a connected composition, giving this exact route a clearer production purpose than a generic image request. This Qwen Image family edit path couples the broader generation model with source-aware revision for application-level image updates.
Use Qwen Image Edit when the project specifically requires a controlled change to supplied imagery. State the creative goal, then define composition, viewpoint, wording, materials, lighting, and finish; for edits, explicitly separate the intended transformation from identity, layout, or regions that must remain stable.
Highlights
- Qwen Image Semantic content editing. Changes object identity, scene meaning, viewpoint, or style through natural language.
- Qwen Image Appearance-level revision. Modifies local color, texture, text, or material while preserving surrounding context.
- Qwen Image Chinese and English text editing. Adds, removes, or replaces bilingual wording in designed imagery.
- Qwen Image family edit path. Connects the broader Qwen Image model family to source-aware revision and preservation-sensitive transformation.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| Base generation | Per request | $0.02 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs this exact named workflow | The intended task belongs to another media route |
| All required reference or control media is available | Necessary assets or rights are unavailable |
| The brief can state transformation and preservation goals | Output must be deterministic at pixel or frame level |
| Supported duration, resolution, and format fit delivery | Final placement requires unsupported specifications |
| An asynchronous generated result fits production | A live frame-synchronous response is mandatory |
Prompt Guide
Identify the primary subject and every source or condition, state the intended transformation or action, then describe composition, camera or viewpoint, lighting, materials, pacing, atmosphere, and exact preservation requirements. Refer to multiple inputs in their schema order.
{
"prompt": "A precisely directed composition with explicit subject, transformation, camera or viewpoint, lighting, material, and preservation requirements",
"image": "https://example.com/reference.png",
"seed": 1,
"strength": 0.6,
"use_turbo": false
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | alibaba/qwen-image/edit |
| Input fields | seed (integer)<br>image (string)<br>prompt (string)<br>strength (number)<br>use_turbo (boolean)<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, image |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
alibaba/qwen-imagealibaba/qwen-image/maxalibaba/qwen-image-edit