> 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 products, text prompts, and image references within a single scene. Place instructions directly on the canvas to define where changes should occur.
### Basic Combo: text instruction and image reference
### Basic Combo: product replacement (precise mode)
***
## Combo Sticker types
Combo has three sticker types. Place one or more on your scene to instruct what to change.
**Text instruction**
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.
**Image reference**
Add a reference image for style, texture, or composition. Use it when a picture explains the change better than words.
**Product reference**
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.
***
## 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 :language: **Language**.
{% endhint %}
{% @arcade/embed flowId="aEoc8iyxJgP9EVeLdNPg" url="" %}
***
## How to use
{% stepper %}
{% step %}
#### Select ”Combo”
In the left task menu, select **Combo**.
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 **Upload an image** 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 **Text instruction sticker**.
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 :xmark: 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 **Image reference 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 changes to take effect.
4. Select an image from your Playground or Upload a new image.
5. If uploading:
* Select the **Upload** tab.
* Select **Upload** 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 :xmark: 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 **Product reference** 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 :xmark: remove button located on the top corner of the sticker.
{% hint style="info" %}
Drawing a specific area improves generation accuracy.
{% endhint %}
{% endstep %}
{% step %}
#### Recommended: Global Text Prompt
Global prompts define overall scene direction.
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 **Library** to re-use a previously saved prompt.
3. From the :cloud-arrow-up: 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 **+ Add image**.
2. Select up to 10 images from the Playground or Upload tab.
3. If uploading:
* Select the **Upload** tab.
* Select **Upload** 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 :xmark: 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.
Available aspect ratios
* 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)
{% 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 **Generate**. You can also switch to the precise effort.
The generated scenes will appear in your Playground.
{% endstep %}
{% endstepper %}
***
## How to use the generation effort
{% stepper %}
{% step %}
#### Open the effort selector
Next to **Generate**, select the arrow to open the effort dropdown.
**Standard** is selected by default.
{% endstep %}
{% step %}
#### Choose Precise for complex elements
Select **Precise** for generations with fine detail, such as packaging shape, embossed logos, or texture.
The **Generate** button's icon and background update to show your selection.
{% endstep %}
{% step %}
#### Generate
Select **Generate**.
**Precise** takes longer than **Standard**, 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 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/combo.md?ask=&goal=
```
`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.
