# Expand

***

<figure><img src="/files/bHM8RIlbmlB0Kovr0Y9P" 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 flowId="ft86jPMZKmiBM2JvAkUK" url="<https://app.arcade.software/share/ft86jPMZKmiBM2JvAkUK>" %}

***

## How to use

{% stepper %}
{% step %}

#### Select ”AI Expand”

In the left task menu, select <kbd><mark style="color:$primary;">**Resize**<mark style="color:$primary;"></kbd> then <kbd><mark style="color:$tint;">**AI Expand**<mark style="color:$tint;"></kbd>

This opens the AI Expand workspace.
{% 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 %}

#### Adjust the Output Size

You may manually adjust the image size directly on the canvas.

Alternatively:

* Use the zoom percentage controls in the AI Expand settings panel on the right side of the scene.

If you want to change the aspect ratio, proceed to the next step.
{% endstep %}

{% step %}

#### Select an Expand Ratio

In the right-side AI Expand settings panel:

* Open the <kbd><mark style="color:$primary;">**Expand Ratio**<mark style="color:$primary;"></kbd> dropdown menu.
* Select the new aspect ratio.

<details>

<summary><strong>Available aspect ratios</strong></summary>

* Portrait (9:16, 768×1344px)
* Widescreen (21:9, 1536×672px)
* Vertical Widescreen (9:21, 672×1536px)
* Flexible 5:4 (5:4, 1152×896px)
* Flexible 4:5 (4:5, 896×1152px)
* Square (1:1, 1024×1024px)
* Photo (3:2, 1248×832px)
* Vertical Photo (2:3, 832×1248px)
* Classic (4:3, 1184×864px)
* Vertical Classic (3:4, 864×1184px)
* Landscape (16:9, 1344×768px)

</details>
{% endstep %}

{% step %}

#### Optional: Add a Text Prompt

In the right-side AI Expand settings panel, you may add a text prompt for overall direction.\
In the Text prompt field:

1. Write directly in the text prompt field.
2. Select <kbd><mark style="color:$primary;">**Library**<mark style="color:$primary;"></kbd> to re-use a previously saved prompt.
3. From the <i class="fa-cloud-arrow-up" style="color:$primary;">:cloud-arrow-up:</i> icon, upload an image and Beachside will create a description and place the text in the prompt field.
   {% endstep %}

{% step %}

#### Expand

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

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


---

# Agent Instructions: 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:

```
GET https://docs.theseaai.com/tasks/expand.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.