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

# Blend

Seamlessly places a product into a background in a single generation step. It automatically adjusts lighting, shadows, and material interaction to integrate both images into one consistent scene.

***

#### Blend one or multiple product layers into a background

Use this when you want to place one or multiple product layers into the background image, with realistic lighting, shadows and angles applied automatically.

{% hint style="info" %}
This task works well with the Split Layers. Split your layers first, adjust their size or position, then blend them back together. [See how to split layers](https://docs.theseaai.com/features/layers.md#split-into-layers)
{% endhint %}

<div data-full-width="false"><figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2F5mN66FCjdNfqwNMCEaKF%2Fgitbook_task_blend_03.png?alt=media&amp;token=05b2c551-dd47-464a-9c05-03cf29987834" alt=""><figcaption></figcaption></figure></div>

#### Replace a product in an existing visual

Use it when you want to replace the product in a reference image for your own, while keeping the same placement and visual details.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FwIFlvlKw4VW8AnPdnnBu%2Fgitbook_task_blend_04.png?alt=media&amp;token=86b49ede-5a47-412c-8956-9942c666fc98" alt=""><figcaption></figcaption></figure>

#### Place a product in a background with a specific prompt

Use it when you need to guide Blend task with your own instructions to achieve a specific result.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FNAuTfQY3jpGCmaOCmMmT%2Fgitbook_task_blend_05.png?alt=media&amp;token=78a07dae-5bf9-4dd7-80c2-da4098e2edd8" alt=""><figcaption></figcaption></figure>

***

## How to use

{% stepper %}
{% step %}

#### Select “Blend”

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

This opens the Blend workspace for your current scene.
{% endstep %}

{% step %}

#### Place image layers to blend into the scene

Upload all the images you’d like to blend into the scene. Blend use all of them to generate the result, following how you’ve arranged them.

You may use a layer created with the [Split Layers](https://docs.theseaai.com/features/layers.md#split-into-layers)

You may upload an image layer 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
  {% endstep %}

{% step %}

#### Optional: Add text prompt

Use the optional <kbd><mark style="color:$primary;">**Prompt**<mark style="color:$primary;"></kbd> field to describe what you want the Blend to focus on, or which area in the image you want it applied.
{% endstep %}

{% step %}

#### Optional: Add a reference image

Select <kbd><mark style="color:$primary;">**+ Add image**<mark style="color:$primary;"></kbd> to upload reference images.

You may use a reference image to:

* Provide a background image to blend your products into
* Give references on how to blend, matching visual and placement details

You can add up to 3 reference images
{% endstep %}

{% step %}

#### Select the Number of Outputs

In the right-side Blend settings panel:

* Select how many variations to generate.
* You may generate up to 4 scenes at once.
  {% endstep %}

{% step %}

#### Select “Blend” and an effort

After confirming all settings, select <kbd><mark style="color:$primary;">**Blend**<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 blend effort

Blend effort controls how closely Blend analyzes your image and how much realistic detail it generates in the result.

* **Standard (default):** Generates quickly, best for most generations. Takes approximately 60 seconds.
* **Precise:** Generates more realistic details. Best for complex products, such as those with embossed logos, reflective surfaces, or intricate shapes. Takes approximately 140 seconds.

<figure><img src="https://3377749587-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOUQ3EAPIPziQuBKQgmTy%2Fuploads%2FLpgbl2Sb9DtSS5JlAZau%2Fgitbook_blend.png?alt=media&amp;token=4c2af083-f1ae-44c0-a8bc-04f858920f0e" alt=""><figcaption></figcaption></figure>

{% stepper %}
{% step %}

#### Open the effort selector

Next to <kbd><mark style="color:$primary;">**Blend**<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 realistic details

Select <kbd><mark style="color:$primary;">**Precise**<mark style="color:$primary;"></kbd> to blend with realistic lighting, shadows, and texture details.

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

{% step %}

#### Blend

Select <kbd><mark style="color:$primary;">**Blend**<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 140 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/blend.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.
