> 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/variation.md).

# Variation

Explore new versions of your image in one step. Each one uses a different composition and angle.

***

## Use Variation to explore different alternatives for

* **An image from Beachside**: Try more alternatives before you continue editing.
* **A photo from a shoot**: Turn a packshot or product photo into alternative directions without rebuilding the scene.

***

## Choose what varies

Variation gives you four ways to shape your results.

#### **Camera angle & Composition**

Use this when you want the widest range of results. Variation changes both the framing and the camera angle across all nine results. This is the default.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FpnaPf2WQAoNugo16K1kc%2Fimage.png?alt=media&amp;token=d8a858b3-eee8-468f-b5b3-21b4b7e9bd5c" alt=""><figcaption></figcaption></figure>

#### **Camera angle**

Use this when you want to keep the current composition and elements placement and only explore different camera angles.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2F1MoRp90dEN06dwXiytWn%2Fimage.png?alt=media&amp;token=439398f0-f220-437c-8b19-51dd5d8f2d3c" alt=""><figcaption></figcaption></figure>

#### **Composition**

Use this when you want to keep the current camera angle and only explore different composition and elements placement.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FanEU6Kgzl1Emjk6q3kpN%2Fimage.png?alt=media&amp;token=d0bf1e12-69bf-4921-a9f5-b5f3a5fed65e" alt=""><figcaption></figcaption></figure>

#### **Prompt**

Use this when you want to specify exactly what should change, or give Variation an instruction beyond angle and composition.

{% hint style="info" %}
If your prompt and a locked toggle point in different directions, Variation follows the prompt.
{% endhint %}

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FVRumqM50oLRJIEHEDOIs%2Fimage.png?alt=media&amp;token=3781cff9-e5e7-45bd-bd89-28bf765488b1" alt=""><figcaption></figcaption></figure>

***

## How to use

{% stepper %}
{% step %}

#### Select "Variation"

In the left task menu, select <kbd><mark style="color:$primary;">**Variation**<mark style="color:$primary;"></kbd>.
{% endstep %}

{% step %}

#### Choose an aspect ratio

Variations are created at 1K. You can get a 2K version of any variation you keep.
{% endstep %}

{% step %}

#### Choose what varies

In the <kbd><mark style="color:$primary;">**Vary**<mark style="color:$primary;"></kbd> section, turn <kbd><mark style="color:$primary;">**Composition**<mark style="color:$primary;"></kbd> and <kbd><mark style="color:$primary;">**Camera angle**<mark style="color:$primary;"></kbd> on or off to choose what you want to vary. See "Choose what varies" above for what each combination does.

Use the optional <kbd><mark style="color:$primary;">**Prompt**<mark style="color:$primary;"></kbd> field to describe what you'd like these variations to focus on. If you turn both toggles off, Prompt becomes required, with a minimum of 3 characters.
{% endstep %}

{% step %}

#### Generate

Select <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>. All nine variations generate together, which takes about 60 seconds.
{% endstep %}

{% step %}

#### Keep what you want

Hover over a variation and select <kbd><mark style="color:$primary;">**Use**<mark style="color:$primary;"></kbd> to keep it. Each kept variation becomes a full-resolution 2K scene. You can keep as many as you like.
{% endstep %}
{% endstepper %}

***

## FAQ

<details>

<summary><strong>What does Variation change?</strong></summary>

Variation explores different compositions and camera angles. It keeps the subject and visual identity of the scene. Turning a toggle off in the Vary section keeps that aspect unchanged instead.

</details>

<details>

<summary><strong>Will Variation work on images with people, or scenes without a product?</strong></summary>

It works best with product images. It also works with people and scenes, but framing or subject may change more than expected, especially with both toggles on.

</details>

<details>

<summary><strong>Do I need to use the Prompt field?</strong></summary>

No, unless both the Composition and Camera angle toggles are off. In that case, Prompt becomes required and needs at least 3 characters before you can select Generate.

</details>

<details>

<summary><strong>What happens if my prompt and a toggle disagree?</strong></summary>

The prompt takes priority. For example, if Camera angle is off and your prompt asks for a different angle, Variation follows the prompt.

</details>

<details>

<summary><strong>Can I continue editing a variation I kept?</strong></summary>

Yes. After you select <kbd><mark style="color:$primary;">**Use**<mark style="color:$primary;"></kbd>, you can keep editing the variation, work with its layers, or download it.

</details>

<details>

<summary><strong>Can I generate more than nine variations?</strong></summary>

Yes. In the Variation view, select <kbd><mark style="color:$primary;">**Generate more variations**<mark style="color:$primary;"></kbd>. A new set appears next to your first results for easy comparison.

</details>

<details>

<summary><strong>Why are the variation previews smaller than my source image?</strong></summary>

Previews use a lower resolution for faster results. Don’t worry. The image returns to its expected size when you select <kbd><mark style="color:$primary;">**Use**<mark style="color:$primary;"></kbd>.

</details>

<details>

<summary><strong>Will my variations appear in my Gallery?</strong></summary>

Only the variations you keep with <kbd><mark style="color:$primary;">**Use**<mark style="color:$primary;"></kbd> are added to your Gallery. The rest remain in the variation grid and are not saved unless you select them.

</details>

<details>

<summary><strong>I asked for 9 variations and got less, why?</strong></summary>

Sometimes, Variation returns fewer than nine results. We show the results that are available. Select <kbd><mark style="color:$primary;">**Generate more variations**<mark style="color:$primary;"></kbd> to try again.

</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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
