---
title: "Relight a photo"
description: "Relight to a described light or a Mood."
sidebar:
  label: relight
---

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

## Synopsis

```sh
motif relight [image] [light] [options]
```

## Example

The same kitchen, lit evenly instead of by one hard window.

```sh
motif relight kitchen.jpg "even overcast light"
```

<div class="docs-pictures docs-pictures-2">
  <figure>
    <img src="/docs/images/commands/kitchen.jpg" alt="A kitchen lit by hard window light" loading="lazy" />
    <figcaption>Before</figcaption>
  </figure>
  <figure>
    <img src="/docs/images/commands/relit.jpg" alt="The same kitchen in even overcast light" loading="lazy" />
    <figcaption>After</figcaption>
  </figure>
</div>

## Options

| Flag | What it does |
| --- | --- |
| `--even` | Restore natural, even lighting. |
| `--flat` | Strip baked-in light and shadow. |
| `--mood <id>` | Light a house mood (choices: "window", "dawn", "raking", "overcast", "lamplit", "nocturne"). |
| `--mask <path>` | Mask image: white marks what to relight. |
| `--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 where a Model has one; any other shows how it is billed. A rate that depends on the size of the file or the length of the clip is a rate, not a total, so check it with a dry run.

| Model | Chosen at | Price |
| --- | --- | ---: |
| IC-Light v2 | Balanced | $0.10/megapixel |
| Qwen Lighting Restoration | Balanced, with `--even` | $0.035/megapixel |
| Qwen Remove Lighting | Balanced, with `--flat` | $0.035/megapixel |

## Dry run

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

```sh
motif relight kitchen.jpg "even overcast light" --dry-run --fields cost,costBasis,output
```

```json
{
  "cost": 0.144,
  "costBasis": "projected",
  "output": "kitchen-relight.png"
}
```