alibaba/qwen-image-edit/2509-lora-gallery/add-background
Qwen Image Edit 2509 Lora Gallery Add Background by Alibaba - AI-powered image editing, style transfer, and transformation. Edit photos with natural language instructions, remove backgrounds, change styles, and enhance i...
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/2509-lora-gallery/add-backgroundInput Schema
8 parameters · 1 required · 7 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | Required | Describe the background/scene you want to add behind the object. The model will remove the white background and add the specified environment. · Default: "Remove white background and add a realistic scene behind the object" |
seed | integer | Optional | Random seed for reproducibility. Same seed with same prompt will produce same result. |
images | string[] | Optional | The URLs of the images to edit. Provide an image with a white or clean background. |
lora_scale | number | Optional | The scale factor for the LoRA model. Controls the strength of the LoRA effect. · Min: 0 · Max: 4 · Default: 1 |
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 output image · Options: png, jpeg · Default: "png" pngjpeg |
guidance_scale | number | Optional | Min: 0 · Max: 20 · Default: 1 |
num_inference_steps | integer | Optional | Min: 2 · Max: 50 · Default: 6 |
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-lora-gallery/add-background",
"images": [
"https://static.sandbase.ai/examples/alibaba/qwen-image-edit-2509-lora-gallery/add-background/input_images_0.png"
],
"prompt": "Add an outdoor scene with mountains and road behind the car",
"lora_scale": 1,
"output_format": "png",
"guidance_scale": 1,
"num_inference_steps": 6
}'
# 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 Lora Gallery
Qwen Image Edit 2509 Lora Gallery is the 2509 route for add background. 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 Lora Gallery when the project specifically requires add background. 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 Subject-safe background replacement. Changes the environment without needlessly regenerating the primary subject.
- 2509 Foreground edge preservation. Retains hair, clothing, and object contours against a new setting.
- 2509 Perspective-matched environment. Builds background scale and geometry that agree with the foreground.
- 2509 Integrated scene illumination. Adapts light and color so subject and new location feel photographed together. The configured adaptation adds task-specific learned behavior.
Pricing
| Configuration | Billing unit | Price |
|---|---|---|
| Base generation | Per request | $0.035 |
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": "Remove white background and add a realistic scene behind the object",
"seed": 1,
"images": [
"https://example.com/reference.jpg"
],
"lora_scale": 1
}
Technical Specs
| Spec | Value |
|---|---|
| Model ID | alibaba/qwen-image-edit/2509-lora-gallery/add-background |
| Input fields | seed (integer)<br>images (array)<br>prompt (string)<br>lora_scale (number; 0–4)<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; png, jpeg)<br>guidance_scale (number; 0–20)<br>num_inference_steps (integer; 2–50) |
| 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