Magic Wand AI

Remove, add, or replace objects and generate the new fill with a prompt. If you want to remove object rather than adding new one, with Magic Wand endpoint, you can use special parameters on prompt.

Note: Also, please check out for Remove Object and Change Material parameters.

POST /v2/generate

Parameters

Name	Type	Description
model	string	Required Value must be magicwand for Magic Wand AI. Browse other Generators.
image	string	Optional URL of the input image. Encode your image url if url have special characters.
mask_image	string	Required URL of the mask image. Learn more about mask images. Encode your image url if url have special characters.
prompt	string	Optional Description of desired design. You can use special parameters.
material_image	string	Optional Material reference image to fill mask area with material. Leave empty for Prompt design or Removing objects.
remove	string	Optional Use true value to
pid	integer	Optional Persona ID to use if you want to use Persona Slots for images.
seed	integer	Optional For reproducible results
enhance_prompt	string	Optional If you want to use Prompt Enhance model, use true value. If you want to continue without Prompt Enhancer don't add enhance_prompt parameter to your requests.
format	string	Optional Output format values: jpg, png or webp
processing_url	string	Optional Get process results with same endpoint, alternative to /results endpoint usage.

Curl Example

curl -X POST https://api.luw.ai/v2/generate \
  -H "Authorization: Bearer LUW_API_TOKEN" \
  -d "model=magicwand" \
  -d "mask_image=https://example.com/roommask.jpg" \
  -d "prompt=Modern minimalist living room" \
  -d "image=https://example.com/room.jpg"

Response Example

{
  "status": true,
  "progress": {
    "started_at": "2024-01-04T12:00:00Z",
    "state": "processing",
    "percent": 45
  },
  "processing": true,
  "processing_url": "abc_123..."
}

✨ Get results using the /results endpoint.

Alternative legacy method: Add &processing_url={url} to your request.

Special Parameters

Remove Furniture

You can execute special actions like Remove Furniture, Remove Object or remove anything selected with mask_image parameter, check Mask Image section for better results.

To switch Remove Object mode, you can simply add remove parameter with true value like this example:

?remove=true

Curl Example

curl -X POST https://api.luw.ai/v2/generate \
  -H "Authorization: Bearer LUW_API_TOKEN" \
  -d "model=magicwand" \
  -d "image=https://example.com/room.jpg" \
  -d "mask_image=https://example.com/roommask.jpg" \
  -d "remove=true"

Material Swap

You can execute special actions like Swap Materials with material_image parameter, it will change Mask Image you provided, with the material image you provided.

To switch Material Swap mode, you can simply add material_image parameter with image url like this example:

curl -X POST https://api.luw.ai/v2/generate \
  -H "Authorization: Bearer LUW_API_TOKEN" \
  -d "model=magicwand" \
  -d "image=https://example.com/room.jpg" \
  -d "mask_image=https://example.com/roommask.jpg" \
  -d "material_image=https://example.com/material.jpg"