# Qwen Image Edit 2509 Lora Gallery > Add a realistic scene behind the object with white background ## Overview - **Endpoint**: `https://fal.run/fal-ai/qwen-image-edit-2509-lora-gallery/add-background` - **Model ID**: `fal-ai/qwen-image-edit-2509-lora-gallery/add-background` - **Category**: image-to-image - **Kind**: inference **Tags**: stylized, transform ## Pricing - **Price**: $0.035 per megapixels For more details, see [fal.ai pricing](https://fal.ai/pricing). ## API Information This model can be used via our HTTP API or more conveniently via our client libraries. See the input and output schema below, as well as the usage examples. ### Input Schema The API accepts the following input parameters: - **`image_urls`** (`list`, _required_): The URLs of the images to edit. Provide an image with a white or clean background. - Array of string - Examples: ["https://v3b.fal.media/files/b/rabbit/YN3dXLQBWb2ch6V607Uuc_d808599bb92f4c808502a118697bdc1f.png"] - **`image_size`** (`ImageSize | Enum`, _optional_): The size of the generated image. If not provided, the size of the final input image will be used. - One of: ImageSize | Enum - **`guidance_scale`** (`float`, _optional_): The CFG (Classifier Free Guidance) scale. Controls how closely the model follows the prompt. Default value: `1` - Default: `1` - Range: `0` to `20` - **`num_inference_steps`** (`integer`, _optional_): The number of inference steps to perform. Default value: `6` - Default: `6` - Range: `2` to `50` - **`acceleration`** (`AccelerationEnum`, _optional_): Acceleration level for image generation. 'regular' balances speed and quality. Default value: `"regular"` - Default: `"regular"` - Options: `"none"`, `"regular"` - **`negative_prompt`** (`string`, _optional_): The negative prompt for the generation Default value: `" "` - Default: `" "` - Examples: " " - **`seed`** (`integer`, _optional_): Random seed for reproducibility. Same seed with same prompt will produce same result. - **`sync_mode`** (`boolean`, _optional_): If `True`, the media will be returned as a data URI and won't be saved in history. - Default: `false` - **`enable_safety_checker`** (`boolean`, _optional_): Whether to enable the safety checker for the generated image. Default value: `true` - Default: `true` - **`output_format`** (`OutputFormatEnum`, _optional_): The format of the output image Default value: `"png"` - Default: `"png"` - Options: `"png"`, `"jpeg"`, `"webp"` - **`num_images`** (`integer`, _optional_): Number of images to generate Default value: `1` - Default: `1` - Range: `1` to `4` - **`prompt`** (`string`, _optional_): Describe the background/scene you want to add behind the object. The model will remove the white background and add the specified environment. Default value: `"Remove white background and add a realistic scene behind the object"` - Default: `"Remove white background and add a realistic scene behind the object"` - Examples: "Add an outdoor scene with mountains and road behind the car", "Add a modern living room background behind the product", "Add a natural outdoor setting with grass and trees as background" - **`lora_scale`** (`float`, _optional_): The scale factor for the LoRA model. Controls the strength of the LoRA effect. Default value: `1` - Default: `1` - Range: `0` to `4` **Required Parameters Example**: ```json { "image_urls": [ "https://v3b.fal.media/files/b/rabbit/YN3dXLQBWb2ch6V607Uuc_d808599bb92f4c808502a118697bdc1f.png" ] } ``` **Full Example**: ```json { "image_urls": [ "https://v3b.fal.media/files/b/rabbit/YN3dXLQBWb2ch6V607Uuc_d808599bb92f4c808502a118697bdc1f.png" ], "guidance_scale": 1, "num_inference_steps": 6, "acceleration": "regular", "negative_prompt": " ", "enable_safety_checker": true, "output_format": "png", "num_images": 1, "prompt": "Add an outdoor scene with mountains and road behind the car", "lora_scale": 1 } ``` ### Output Schema The API returns the following output format: - **`images`** (`list`, _required_): The generated/edited images - Array of Image - Examples: [{"url":"https://v3b.fal.media/files/b/lion/d_xp44RvnuYYxioxBgAlX.png"}] - **`seed`** (`integer`, _required_): The seed used for generation **Example Response**: ```json { "images": [ { "url": "https://v3b.fal.media/files/b/lion/d_xp44RvnuYYxioxBgAlX.png" } ] } ``` ## Usage Examples ### cURL ```bash curl --request POST \ --url https://fal.run/fal-ai/qwen-image-edit-2509-lora-gallery/add-background \ --header "Authorization: Key $FAL_KEY" \ --header "Content-Type: application/json" \ --data '{ "image_urls": [ "https://v3b.fal.media/files/b/rabbit/YN3dXLQBWb2ch6V607Uuc_d808599bb92f4c808502a118697bdc1f.png" ] }' ``` ### Python Ensure you have the Python client installed: ```bash pip install fal-client ``` Then use the API client to make requests: ```python import fal_client def on_queue_update(update): if isinstance(update, fal_client.InProgress): for log in update.logs: print(log["message"]) result = fal_client.subscribe( "fal-ai/qwen-image-edit-2509-lora-gallery/add-background", arguments={ "image_urls": ["https://v3b.fal.media/files/b/rabbit/YN3dXLQBWb2ch6V607Uuc_d808599bb92f4c808502a118697bdc1f.png"] }, with_logs=True, on_queue_update=on_queue_update, ) print(result) ``` ### JavaScript Ensure you have the JavaScript client installed: ```bash npm install --save @fal-ai/client ``` Then use the API client to make requests: ```javascript import { fal } from "@fal-ai/client"; const result = await fal.subscribe("fal-ai/qwen-image-edit-2509-lora-gallery/add-background", { input: { image_urls: ["https://v3b.fal.media/files/b/rabbit/YN3dXLQBWb2ch6V607Uuc_d808599bb92f4c808502a118697bdc1f.png"] }, logs: true, onQueueUpdate: (update) => { if (update.status === "IN_PROGRESS") { update.logs.map((log) => log.message).forEach(console.log); } }, }); console.log(result.data); console.log(result.requestId); ``` ## Additional Resources ### Documentation - [Model Playground](https://fal.ai/models/fal-ai/qwen-image-edit-2509-lora-gallery/add-background) - [API Documentation](https://fal.ai/models/fal-ai/qwen-image-edit-2509-lora-gallery/add-background/api) - [OpenAPI Schema](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/qwen-image-edit-2509-lora-gallery/add-background) ### fal.ai Platform - [Platform Documentation](https://docs.fal.ai) - [Python Client](https://docs.fal.ai/clients/python) - [JavaScript Client](https://docs.fal.ai/clients/javascript)