> For the complete documentation index, see [llms.txt](https://docs.m-xr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.m-xr.com/marso-studio/reference/nodes-reference.md).

# Nodes reference

Marso Studio is built around **nodes**. Each node is one step — generate or load an asset, generate or edit an image, apply materials. Connect a node's output to the next node's input to build a pipeline, or start from a **template** that wires a pipeline up for you.

Nodes are grouped into **Image**, **3D**, **Utility** and **Templates**.

### Image

#### Image Upload

Upload an image to use as a starting point in your pipeline.

* **Input:** image file
* **Output:** image
* **Cost:** no credits

#### Image Generation

Generate an image from a text prompt.

* **Input:** text prompt
* **Output:** image
* **Cost:** 1 credit

#### Multiview

Generate a multi-view set of an object from a single image — useful for a stronger 3D reconstruction.

* **Input:** image
* **Output:** multiple views of the object
* **Cost:** 4 credits

#### Image Edit

Edit or refine an existing image with a prompt.

* **Input:** image + prompt
* **Output:** edited image
* **Cost:** 1 credit

### 3D

#### Load 3D Model

Upload your own 3D asset (`.glb`, `.usdz` or `.fbx`). See [3D file support](/marso-studio/preparing-your-assets/3d-file-support.md).

* **Input:** 3D file
* **Output:** 3D model
* **Cost:** no credits

#### Generate 3D Model

Turn an image into a 3D mesh.

* **Input:** an image, or a multi-view set
* **Output:** 3D model
* **Cost:** 4 credits (single image) · 5 credits (multi-view input)

### Utility

#### Generate PBR Textures

Run I2M to predict a full PBR material stack — **albedo, metallic, roughness and IOR** — for a textured mesh.

* **Input:** textured 3D model
* **Output:** textured 3D model + individual PBR maps
* **Cost:** 10 credits

### Templates

Pre-built pipelines that wire nodes together for common journeys:

* **PBR Pipeline** — Load 3D Model → Generate PBR Textures. See Apply PBR to your own model.
* **Generate 3D Pipeline** — Image Generation → Generate 3D Model → Generate PBR Textures. See From image to textured 3D.

### Credit costs at a glance

| Node                             | Credits |
| -------------------------------- | ------- |
| Image Upload                     | —       |
| Image Generation                 | 1       |
| Image Edit                       | 1       |
| Multiview                        | 4       |
| 3D Model Upload                  | —       |
| Generate 3D Model (single image) | 4       |
| Generate 3D Model (multi-view)   | 5       |
| Generate PBR Textures            | 10      |

See [Credits & billing](/marso-studio/reference/credits-and-billing.md) for how credits work.


---

# 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.m-xr.com/marso-studio/reference/nodes-reference.md?ask=<question>&goal=<endgoal>
```

`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.
