# Combo

{% hint style="danger" %}
**Combo** is a beta feature and may not function as expected.
{% endhint %}

***

#### Basic Combo: products, text instruction and image reference.

<figure><img src="/files/Z7N19BpXxL7LzLCmoqM1" alt=""><figcaption></figcaption></figure>

***

## Interactive Tutorials

{% 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="aEoc8iyxJgP9EVeLdNPg" url="<https://app.arcade.software/share/aEoc8iyxJgP9EVeLdNPg>" %}

***

## How to use

{% stepper %}
{% step %}

#### Select ”Combo”

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

This opens the Combo 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 %}

#### Add a Text Instruction Sticker

From the tools dock at the bottom of the screen:

1. Select the <kbd><mark style="color:$primary;">**Text instruction sticker**<mark style="color:$primary;"></kbd>.
2. Click anywhere on the scene to place the sticker.
3. Optional: Before placing the sticker, select and drag to draw a square over the area where you want changes to take effect.
4. Enter your instruction text.
5. Press Enter to confirm.

To remove a sticker, select the <i class="fa-xmark" style="color:$primary;">:xmark:</i> remove button located on the top corner of the sticker.

{% hint style="info" %}
Drawing a specific area improves generation accuracy.
{% endhint %}

{% hint style="warning" %}
Avoid placing too many instruction stickers simultaneously.
{% endhint %}
{% endstep %}

{% step %}

#### Add an Image Reference Sticker

1. Select the <kbd><mark style="color:$primary;">**Image reference sticker**<mark style="color:$primary;"></kbd>.
2. Click anywhere on your scene to add your sticker.
3. Optional: Before placing the sticker, select and drag to draw a square over the area where you want changes to take effect.
4. Select an image from your Playground or Upload a new image.
5. If uploading:
   * Select the <kbd><mark style="color:$primary;">**Upload**<mark style="color:$primary;"></kbd> tab.
   * Select <kbd><mark style="color:$primary;">**Upload**<mark style="color:$primary;"></kbd> or choose a previously uploaded image.
6. Optional: add a short text instruction to specify how the reference image should be interpreted.
7. Press Enter to confirm.

To remove a sticker, select the <i class="fa-xmark" style="color:$primary;">:xmark:</i> remove button located on the top corner of the sticker.

{% hint style="info" %}
Drawing a specific area improves generation accuracy.
{% endhint %}

{% hint style="warning" %}
Avoid placing too many instruction stickers simultaneously.
{% endhint %}
{% endstep %}

{% step %}

#### Recommended: Global Text Prompt

Global prompts define overall scene direction.&#x20;

In the right-side Generation 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 %}

#### Recommended: Add Global Reference Images

Always specify your requirements from a reference image, both globally and within the scene context.

In the right-side Global Combo Settings settings panel:

1. Select <kbd><mark style="color:$primary;">**+ Add image**<mark style="color:$primary;"></kbd>.
2. Select up to 10 images from the Playground or Upload tab.
3. If uploading:
   * Select the <kbd><mark style="color:$primary;">**Upload**<mark style="color:$primary;"></kbd> tab.
   * Select <mark style="color:$primary;">**Upload**</mark> or choose a previously uploaded image.
4. After adding an image:
   * Select the description field beside the image labeled Specify.
   * Enter a short description (up to 30 characters).
5. To remove a reference image:
   * Hover over the image number.
   * Select the <i class="fa-xmark" style="color:$primary;">:xmark:</i> button.
     {% endstep %}

{% step %}

#### Select an Aspect Ratio

In the right-side Generation settings panel:

* Select how many variations to generate.
* You may generate up to 4 scenes at once.

<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 %}

#### Select the Number of Outputs

On the generation settings panel, on the right side of the scene, you may generate up to 4 different scenes at a time.
{% endstep %}

{% step %}

#### Select “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 %}


---

# 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/combo.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.