# Scene Functionality

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FMbnxoGBzzFiKN3aBcuxU%2Fimage.png?alt=media&#x26;token=62837879-d9f0-4bde-8784-b6ae0c3d0439" alt="" width="563"><figcaption></figcaption></figure>

{% embed url="<https://youtu.be/SpxJTxNlmMo?feature=shared>" %}
How to create a Scene
{% endembed %}

| [What is a scene?](#what-is-a-scene)              |
| ------------------------------------------------- |
| [Marking objects](#marking-objects)               |
| [Choosing a quality](#choosing-a-quality)         |
| [Input image guidelines](#input-image-guidelines) |

### What is a scene?

Scenes are generations with multiple objects. The objects will be generated in the correct scale and position as shown in your input image.

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FjZVcFv7HyE6j6sgbppSv%2FCafe02.png?alt=media&#x26;token=747a658a-e387-4b54-bce0-8c07a7aa32f3" alt=""><figcaption><p>Scenes will be generated without color.</p></figcaption></figure>

{% hint style="info" %}
To find out more about input guidelines for scenes, see [here](https://docs.kaedim3d.com/creating-assets/input-guidelines#scenes-enterprise).
{% endhint %}

## Creating a Scene

### Upload an image

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FA9zZpZARGqggrYCMEFpN%2F60070e4a-f062-423a-8c58-7fdcdc41ee6d.jpeg?alt=media&#x26;token=ce08d51f-2e2e-4734-af8a-c78a7af705f3" alt="" width="375"><figcaption></figcaption></figure>

You can only upload a single image of your scene. To learn more about scene input image guidelines, see [here](https://docs.kaedim3d.com/creating-assets/input-guidelines/input-image-examples/scenes).

### Marking objects

After you've uploaded your image, the background will be removed and the objects within the scene will be marked automatically. Object markers will be color coded, as seen below. You can also delete markers by clicking on the trash icon on the right.

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FJgV1biI0I0KIrNGpKspm%2Fimage.png?alt=media&#x26;token=f89a6bae-913a-409c-95d2-25b216ea96c0" alt="" width="563"><figcaption></figcaption></figure>

If some objects were missed, you can mark them manually by clicking and dragging your cursor across the object. You will see a selection box (see below).

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FPof0RHxkEgdNcKCcjYEx%2FScreenshot%202025-05-14%20at%206.38.32%E2%80%AFPM.png?alt=media&#x26;token=2b2de2d8-3e5f-4be5-aaf0-7daecb3a63b0" alt="" width="164"><figcaption></figcaption></figure>

Once you have created a box, you can then click "Mark as object." You will then see a new object added onto the list on the right.

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2Fu7SqPA0ZFvEA5j81TXab%2FScreenshot%202024-06-26%20at%208.53.29%E2%80%AFPM.png?alt=media&#x26;token=a3b24187-4962-40b0-a422-e867bf79ba77" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about input guidelines for scenes [here](https://docs.kaedim3d.com/creating-assets/input-guidelines#scenes).
{% endhint %}

***

### Choosing a quality

After selecting objects for generation, choose a quality level in the sidebar. You can also set a max polycount here.

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FQVLgnnoStIw2uGksHbCZ%2Fimage.png?alt=media&#x26;token=a4a680d5-282e-479b-b23a-8f33a5b60cea" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2929718666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dfqxWeW1YVSmrxYlvkW%2Fuploads%2FQgCb6pF2YUzX9dDGzRAn%2Fimage.png?alt=media&#x26;token=3dca5ef9-0599-4b42-be15-59cf356146ab" alt="" width="563"><figcaption></figcaption></figure>

Scene construction is included at no extra cost and each object in the scene is generated at the selected level of quality. For example, if you have marked 4 objects and you choose High quality (2 credits), your scene would cost 8 credits.

***

### Input image guidelines

### Checklist

#### ✅ Under 20 objects

* Please make sure to keep scenes at a maximum of 20 objects.
* This ensures that all objects are **clear and visible** within the image.

#### ✅ Clear background - Your objects need to be clearly distinguishable from the background.

#### ✅ Photo/Art/Sketch - Your 2D input can be a photo of your scene (within guidelines, see below), a piece of concept art, or a sketch (pencil, pen, or paper).

#### ✅ Clear - The object should be clearly visible in the foreground of the image. Avoid blurry images.

***

### Invalid and Tricky Inputs

Below are some examples of image requests that may not be processed:

#### ❌ Hidden objects

If many objects are hidden or partially hidden, your request may be dismissed.

#### ❌ Inappropriate imagery

This includes any nude or sexual content, offensive imagery, blood and gore, etc. Any images of this type will be automatically dismissed.

**Feel free to experiment with various inputs. You might be surprised by our software's capability!**

{% hint style="warning" %}
Please refrain from uploading any inputs that contain personal information or identifiable details such as passports, ID cards, or addresses.
{% endhint %}


---

# 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.kaedim3d.com/enterprise-features/scene-functionality.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.
