Guide

Item removal

Remove clutter, furniture or a named object from a photo.

Item removal takes things out of a photo and reconstructs what was behind them: personal effects on every surface, a car on the driveway, a bin, a sign, a piece of furniture that dates the room. Agents use it to depersonalise a listing, but it is equally the tool for an e-commerce team clearing a product shot and a contractor photographing a site without the equipment in frame.

Options

This tool has no guided options of its own. You drive it in one of two ways.

Remove obvious clutter

Omit options entirely and it clears the obvious clutter on its own — the usual pass for depersonalising a room.

{
  "tool": "item-removal",
  "image_url": "https://example.com/cluttered-living-room.jpg"
}

Name what to remove

To target something specific, set tier to custom and describe it in customPrompt. The prompt is required when tier is custom, and may be at most 500 characters.

{
  "tool": "item-removal",
  "image_url": "https://example.com/driveway.jpg",
  "options": {
    "tier": "custom",
    "customPrompt": "Remove the silver car on the driveway and the wheelie bin beside the garage door. Rebuild the driveway surface and the hedge behind them."
  }
}

A second example, for an interior:

{
  "tool": "item-removal",
  "image_url": "https://example.com/family-room.jpg",
  "options": {
    "tier": "custom",
    "customPrompt": "Remove all framed photographs, the children's toys on the rug, and the magazines on the coffee table. Leave the furniture and the rug in place."
  }
}

Writing a good prompt

Name the objects and where they are, and say what should be left alone. "Remove the red chair in the left foreground" beats "remove the chair", and "leave the rug" stops the model tidying more than you asked.

Removal is reconstruction: whatever was behind the object has to be invented, so the larger the object and the more of the scene it hides, the more the result is a guess. A bin against a plain wall is reliable; a sofa hiding half a room is not.

Next steps

• Tools — the rest of the launch set and the common options.
• Quickstart — send this request end to end.