---
title: "Remove an object"
description: "Remove something and fill the gap."
sidebar:
  label: erase
---

{/* Generated by scripts/generate-commands.ts. Do not edit. */}

## Synopsis

```sh
motif erase [what] [image] [options]
```

## Example

Take the printed label off the card and keep the paper.

```sh
motif erase --text label.jpg
```

<div class="docs-pictures docs-pictures-2">
  <figure>
    <img src="/docs/images/commands/label.jpg" alt="A paper card printed with the name Salvage and Co on a plaster ground" loading="lazy" style={{ aspectRatio: "1400 / 781", objectFit: "cover" }} />
    <figcaption>Before</figcaption>
  </figure>
  <figure>
    <img src="/docs/images/commands/label-erased.jpg" alt="The same card, blank, with its shadow and edges unchanged" loading="lazy" style={{ aspectRatio: "1400 / 781", objectFit: "cover" }} />
    <figcaption>After</figcaption>
  </figure>
</div>

## Options

| Flag | What it does |
| --- | --- |
| `--boxes <x,y,w,h;...>` | Remove whatever falls inside these boxes, in pixels. |
| `--text` | Remove all rendered text. |
| `--with <fill>` | Fill the masked region with this, described in words. |
| `--mask <path>` | Mask image: white marks what to remove. |
| `--tier <tier>` | Trade cost against quality: fast, balanced, quality. |
| `--dry-run` | Validate and price the call without running it. |

It also takes the [common options](/docs/commands#common-options).

## Models and price

Motif picks the Model for the Tier. Prices are per image.

| Model | Chosen at | Price |
| --- | --- | ---: |
| Object Removal | Balanced | $0.024 |
| Object Removal by Mask | Balanced, when you pass a mask | $0.024 |
| Object Removal by Box | Balanced, with `--boxes` | $0.024 |
| Text Removal | Balanced, with `--text` | $0.040 |
| Bria GenFill | Balanced, with `--with`, when you pass a mask | $0.040 |
| Finegrain Object Eraser | Quality | $0.270 |
| Bria Eraser | Quality, when you pass a mask | $0.040 |

## Dry run

Check the cost before you spend. The output path is where the file would go.

```sh
motif erase --text label.jpg --dry-run --fields cost,costBasis,output
```

```json
{
  "cost": 0.04,
  "costBasis": "projected",
  "output": "label-erase-text.png"
}
```