alibaba/qwen-image-edit-2509
Qwen Image Edit 2509 by Alibaba - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance images effortlessly.
PNG, JPEG, WebP, or GIF · 20 MiB maximum each
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-edit-2509Input Schema
7 parameters · 1 required · 6 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
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. |
images | string[] | Optional | The URLs of the images to edit. |
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 |
guidance_scale | number | Optional | Min: 0 · Max: 20 · Default: 4 |
num_inference_steps | integer | Optional | Min: 2 · Max: 100 · Default: 50 |
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-2509",
"images": [
"https://static.sandbase.ai/examples/alibaba/qwen-image-edit-2509/input_images_0.png",
"https://static.sandbase.ai/examples/alibaba/qwen-image-edit-2509/input_images_1.png",
"https://static.sandbase.ai/examples/alibaba/qwen-image-edit-2509/input_images_2.png"
],
"prompt": "Close shot of a woman standing in next to this car on this highway",
"output_format": "png",
"guidance_scale": 4,
"num_inference_steps": 50
}'
# 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 2509
Qwen Image Edit 2509 is the 2509 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.
Use Qwen Image Edit 2509 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
- 2509 Semantic content editing. Changes object identity, scene meaning, viewpoint, or style through natural language.
- 2509 Appearance-level revision. Modifies local color, texture, text, or material while preserving surrounding context.
- 2509 Chinese and English text editing. Adds, removes, or replaces bilingual wording in designed imagery.
- 2509 Source identity and layout preservation. Retains unrequested subjects, composition, and visual structure through revision.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| Base generation | Per request | $0.03 |
When to Use
| ✅ Good fit | ❌ Consider alternatives |
|---|---|
| The project needs an existing image needs a controlled revision | The intended task belongs to a different media workflow |
| The available inputs match every required local field | Required source material or usage permission is unavailable |
| Creative direction can identify subject, style, and delivery | The output must be deterministic at pixel or waveform level |
| The supported route controls fit the final placement | Delivery requires unsupported formats or dimensions |
| An asynchronous generated result fits production | A live or frame-synchronous response is mandatory |
Prompt Guide
Write the request as a production brief. Identify the subject or source, state the intended result, describe composition and visual or vocal character, then list exact preservation and delivery constraints. For edits, explicitly separate what must change from what must remain unchanged.
{
"prompt": "A polished editorial composition with a clear subject, controlled lighting, balanced layout, and precisely preserved details",
"seed": 1,
"images": [
"https://example.com/reference.jpg"
],
"aspect_ratio": "21:9"
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | alibaba/qwen-image-edit-2509 |
| 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)<br>guidance_scale (number; 0–20)<br>num_inference_steps (integer; 2–100) |
| Required input | prompt |
| Output fields | url, content_type |
| Execution | Asynchronous job |
Related Models
alibaba/qwen-image-2alibaba/qwen-image-2/editalibaba/qwen-image-2/pro