> For the complete documentation index, see [llms.txt](https://docs.theseaai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theseaai.com/tasks/retouch.md).

# Retouch

Apply automatic image corrections in a single generation step. Retouch adjusts lighting, color balance, geometry, surface details, hair, and background cleanliness while preserving the composition.

***

#### Retouch a product image

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2F2S680QzGYQyrFxq49yf8%2Fimage.png?alt=media&amp;token=3f2d6429-1069-4754-b21f-21d0f006b8df" alt=""><figcaption></figcaption></figure>

#### Retouch hair

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FN602xbaG0dtBv69ZAPvD%2Fimage.png?alt=media&amp;token=459f872b-ab17-4e12-8829-629f72600d2a" alt=""><figcaption></figcaption></figure>

***

## Interactive Tutorial

{% hint style="info" icon="language" %}
**How to Change Your Tutorial Language**\
Tutorials are shown in English by default. To view this tutorial in a different language, hover over the top right corner and select <i class="fa-language">:language:</i> **Language**.
{% endhint %}

{% @arcade/embed url="<https://app.arcade.software/share/amHhRqnkiRXfvdtIMe9r>" flowId="amHhRqnkiRXfvdtIMe9r" %}

***

## How to use

{% stepper %}
{% step %}

#### Select "Retouch"

In the left task menu, select <kbd><mark style="color:$primary;">**Retouch**<mark style="color:$primary;"></kbd>.

This opens the Retouch workspace for your current scene.
{% endstep %}

{% step %}

#### Upload a product image

The product image will be used as the foreground element.

You may upload an image by:

* Selecting <kbd><mark style="color:$primary;">**Upload an image**<mark style="color:$primary;"></kbd> inside the scene
* Dragging and dropping an image from a folder on your computer
* Dragging and dropping an image from the Library panel at the bottom-left of the screen

Once uploaded, the product will appear in the scene.
{% endstep %}

{% step %}

#### Keep or change the angle

In the <mark style="color:$tint;">**Product settings**</mark> section of the right-side panel, Retouch keeps your product's original angle by default.

Turn on <kbd><mark style="color:$primary;">**Allow angle changes**<mark style="color:$primary;"></kbd> if you want Retouch to adjust the angle too.
{% endstep %}

{% step %}

#### Add reference images

Still in <mark style="color:$tint;">**Product settings**</mark>, you can add reference images of your product.

Select <kbd><mark style="color:$primary;">**+ Add image**<mark style="color:$primary;"></kbd> to upload a reference image. Reference images help Retouch keep your product's details accurate.

This step is optional.
{% endstep %}

{% step %}

#### Select the number of outputs

In the right-side generation Retouch settings panel:

* Select how many variations to generate.
* You may generate up to 2 scenes at once.
  {% endstep %}

{% step %}

#### Choose generation effort

Next to <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd> select the arrow to open the effort dropdown. See [#choose-generation-effort](#choose-generation-effort "mention")

* <kbd><mark style="color:$primary;">**Standard**<mark style="color:$primary;"></kbd> is selected by default
* <kbd><mark style="color:$primary;">**Precise**<mark style="color:$primary;"></kbd> for product with fine or complex details
  {% endstep %}

{% step %}

#### Generate

After confirming all settings, select <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>.

The generated scenes will appear in your Playground.
{% endstep %}
{% endstepper %}

***

## Product settings

Product settings let you choose whether to keep the original angle, and add a reference image to keep details accurate. This is especially useful for products with a complex shape or fine details.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FgCD5B8DlaqRB8Ea9upd6%2Fimage.png?alt=media&amp;token=285c6d49-f1b6-46b6-ab9a-fa4634e0b8f0" alt=""><figcaption></figcaption></figure>

#### **Keep the product's original angle (default)**

Use when you already shot the product at the exact angle you want.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2Fmo8yWeumHO1ngOiLmzJP%2Fimage.png?alt=media&amp;token=f21272d8-f4cc-43df-97c7-16ac5fd61823" alt=""><figcaption></figcaption></figure>

#### **Let Retouch change the angle**

Use when you want Retouch to find a cleaner or more consistent angle.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2Figb2VwRlvMGvH7VrmFZj%2Fimage.png?alt=media&amp;token=4ee3d5ff-b9c5-45ed-bf4d-b5c546b0ee74" alt=""><figcaption></figcaption></figure>

#### **Match product details with a reference image**

Use when your product has fine details or a complex shape that Retouch might not get right on its own.

{% hint style="info" %}
For best results, select **Precise** generation effort when using reference images on complex products.
{% endhint %}

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FOcEjqIli9iNBbJcGvL3W%2Fimage.png?alt=media&amp;token=b6171826-5297-4e26-8c46-8ff79c6d86b5" alt=""><figcaption></figcaption></figure>

***

### Generation effort for Retouch

Generation effort controls how closely Retouch analyzes your image before generating, so fine detail on complex products comes through intact.

There are two effort levels:

* **Standard** (default): best for most generations. Takes approximately 60 seconds.
* **Precise**: analyzes your image closely, best for complex products. Takes approximately 140 seconds.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FxrZDZuWa5OlGR4KxxmGI%2Fimage.png?alt=media&amp;token=9c297381-7206-45a9-8f92-2a258b17983e" alt=""><figcaption></figcaption></figure>

***

## Hair retouch

Beachside recognizes hair in your image and retouches it automatically, smoothing flyaways, boosting shine, and adding fullness.

***

## FAQ

<details>

<summary><strong>How many reference images can I add, and what do they do?</strong></summary>

* You can add up to 3 reference images per product.
* Reference images help Retouch match your product's real details, so they don't need extra instructions or prompts.

</details>

<details>

<summary><strong>Why is the angle locked by default?</strong></summary>

Retouch keeps the angle from your uploaded photo by default, so your product stays consistent with what you shot. Turn on <kbd><mark style="color:$primary;">**Allow angle changes**<mark style="color:$primary;"></kbd> if you'd rather let Retouch adjust the angle for you.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.theseaai.com/tasks/retouch.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.