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

# Combo

Combine a product, text instructions, image references, and labels in a single scene. You place stickers on the canvas to define where each change happens.

### Basic Combo: text instruction and image reference

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FU2j7jgmEfoeOnXNDZ9ZK%2Fgitbook_task_combo_01.png?alt=media&amp;token=e64a66f4-c0b0-4e91-8ed6-88f14ae45638" alt=""><figcaption></figcaption></figure>

### Basic Combo: product replacement (precise mode)

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FzmUBhSMNdD13vwqW6vGJ%2Fimage.png?alt=media&amp;token=8464ea18-3c74-4604-8762-fd1e6ba66b22" alt=""><figcaption></figcaption></figure>

### Basic Combo: label replacement (precise mode)

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2F1bUk30HJpsp6wpufW2v8%2Fimage.png?alt=media&amp;token=f5ef7766-7ce6-419a-a3b1-156e35923550" alt=""><figcaption></figcaption></figure>

***

## Combo Sticker types

Combo has three sticker types. Place one or more on your scene to instruct what to change.

<kbd><mark style="color:$primary;">**Text instruction**<mark style="color:$primary;"></kbd>

Describe a change in words. Use it when you know exactly what you want to say, like adding condensation to a bottle or darkening a background.

<kbd><mark style="color:$primary;">**Image reference**<mark style="color:$primary;"></kbd>

Add a reference image for style, texture, or composition. Use it when a picture explains the change better than words.

<kbd><mark style="color:$primary;">**Product reference**<mark style="color:$primary;"></kbd>

Use a product reference to bring a specific product into your scene, whether you're replacing a product that's already there or adding a new one.

<kbd><mark style="color:$primary;">**Label reference**<mark style="color:$primary;"></kbd>

Bring a product's label or logo into the scene, to replace an existing one or add a new one.

***

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

#### Add a Product Reference Sticker

1. Select the <kbd><mark style="color:$primary;">**Product reference**<mark style="color:$primary;"></kbd> sticker.
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 the product to appear.
4. Select your product from:
   * The **Playground** tab, to reuse a product from a previous scene
   * The **Library** tab, to pick from your organization's asset library
   * The **Upload** tab, to add a new image

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

{% step %}

#### Add a Label reference sticker

Select the <kbd><mark style="color:$primary;">**Label reference**<mark style="color:$primary;"></kbd> sticker, then click the scene to drop it, or drag first to draw an area over the target spot.

Pick a reference image from the **Playground**, **Library**, or **Upload** tab. You can use an image of the label or logo alone, or a full product photo that includes it. Combo finds the label in the image automatically.

If the reference has more than one label and you want to isolate a specific one, add a note in the <kbd><mark style="color:$primary;">**Specify more detail**<mark style="color:$primary;"></kbd>.
{% 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

Choose an output ratio that fits how you will use the image. Keep the current ratio if it already works.

<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” and an effort

After confirming all settings, select <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>. You can also switch to the precise effort.

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

***

## How to use the generation effort

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FdKqi8VyvWLGYWI6tY0zF%2Fimage.png?alt=media&amp;token=da141792-5bf2-435f-b873-7de1396310e9" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Open the effort selector

Next to <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>, select the arrow to open the effort dropdown.

<kbd><mark style="color:$primary;">**Standard**<mark style="color:$primary;"></kbd> is selected by default.
{% endstep %}

{% step %}

#### Choose Precise for complex elements

Select <kbd><mark style="color:$primary;">**Precise**<mark style="color:$primary;"></kbd> for generations with texts, fine detail, such as packaging shape, embossed logos, or texture.

The <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd> button's icon and background update to show your selection.
{% endstep %}

{% step %}

#### Generate

Select <kbd><mark style="color:$primary;">**Generate**<mark style="color:$primary;"></kbd>.

<kbd><mark style="color:$primary;">**Precise**<mark style="color:$primary;"></kbd> takes longer than <kbd><mark style="color:$primary;">**Standard**<mark style="color:$primary;"></kbd>, approximately 90 seconds.
{% endstep %}
{% endstepper %}


---

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