> 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/credits-and-billing.md). # Credits & billing Marso Studio runs on **credits**. Every generation step spends a set number, and your balance is shown at the top of the screen at all times. Costs scale with the work involved — generating an image is cheap, generating and texturing a 3D object costs more, and a scene costs the sum of its objects. On a scene, what moves the total most is **how many objects you keep**: each one is charged for its reference image, its 3D model and its PBR. Your 3D generator sets the price of the middle one. ## What each step costs | What you do | Node | Credits | | ---------------------------------- | --------------------------------- | -------------------------------------------------- | | Apply PBR materials to a 3D model | Generate PBR Textures | **30** | | Make a material from an image | Generate PBR Textures | **35** up to 1 megapixel, **40** above — see below | | Image → 3D model | Generate 3D Model | **30–45** — see below | | Generate a scene image | Generate Image (Scene tab) | **10** | | Break a scene into objects | Detect Objects | **20** | | Reference images for scene objects | Generate Reference Images (Group) | **10** per object | | Generate an image | Generate Image | **10** | | Edit an image | Edit Image | **10** | | Change a 3D model's texture | Edit 3D Model | **30** | | Generate a multi-view image set | Generate Multiview | **12** (2 per view) | | Upload an image | Load Image | Free | | Upload a 3D model | Load 3D Model | Free | | Mesh compression | — | Free, automatic | See the [Nodes reference](/marso-studio/reference/nodes-reference.md) for what each step does. ## What a material from an image costs A material from an image is priced on the size of the image you give it: **35 credits** up to 1 megapixel (1,048,576 pixels), **40** above that. Two choices add to it: | Choice | Credits | | ----------------- | ------- | | **Not tiled** | — | | **Already tiled** | — | | **Make tileable** | **+10** | | **Displacement** | **+10** | So the most one image can cost is 60: an image above 1 megapixel, made tileable, with displacement. The **Texture** app charges the same, plus 10 for the image when you start from text. See [Make a material from an image](/marso-studio/workflows/make-a-material-from-an-image.md). ## What the 3D generators cost **Generate 3D Model** lets you pick which reconstruction model runs, and they aren't priced the same: | Generator | Single image | Custom face count | Multi-view input | | ---------------------------------- | ------------ | -------------------- | ---------------- | | **Tripo H3.1** | **30** | 30 — no extra charge | Not supported | | **Hunyuan 3D 3.1 Pro** *(default)* | **40** | 55 *(+15)* | **60** | | **Meshy 6** | **45** | 45 — no extra charge | Not supported | | **Meshy 7** | **45** | 45 — no extra charge | Not supported | | **Meshy 7.1** | **45** | 45 — no extra charge | Not supported | **Tripo H3.1 is the cheapest**, and cheaper than the default. The three Meshy models cost the same. Switching generator re-runs the generation, charged at that generator's rate. > **Custom face count is only charged on Hunyuan 3D 3.1 Pro.** Setting a target polycount adds **15 credits** to Hunyuan's base, so a Hunyuan generation with a custom face count is **55 credits** — and on Hunyuan it's single-image only. On Tripo H3.1 and the Meshy models a custom face count is included in the base price. The Meshy models and Tripo H3.1 also have a **Texture** setting. On Meshy, **2K** and **4K** (the default) are in the base price and **8K** adds **10 credits**, so 55. On Tripo H3.1, **Standard** (the default) is in the base price and **Detailed** adds **10**, so 40. Only **Hunyuan 3D 3.1 Pro** accepts multi-view input, so the **Generate Multiview** node (12 credits) feeds a Hunyuan generation. A multi-view run is 12 for the views plus 60 for the model. ## Budgeting a run Plan per object, not per pipeline — and settle on a generator first, because it sets the per-object cost. **One object, generated from scratch and textured:** | Step | Tripo H3.1 | Hunyuan 3D 3.1 Pro *(default)* | Meshy 6, 7 or 7.1 | | --------------------- | ---------- | ------------------------------ | ----------------- | | Generate Image | 10 | 10 | 10 | | Generate 3D Model | 30 | 40 | 45 | | Generate PBR Textures | 30 | 30 | 30 | | **Per object** | **70** | **80** | **85** | Those are the default texture settings. **8K** on a Meshy model, or **Detailed** on Tripo H3.1, adds 10 to each object. **One object you already have — 30 credits**, whichever generator is selected. Upload it and run Generate PBR Textures; uploading is free and no reconstruction runs. **A scene — 30 credits up front, plus the per-object cost above.** The scene image and the detection are charged once; then every object you keep runs its own reference image, 3D model and PBR: | Stage | Charged | Credits | | ---------------------- | ---------- | ----------------------- | | Generate Image (Scene) | once | 10 | | Detect Objects | once | 20 | | Reference images | per object | 10 | | Generate 3D Model | per object | **30–45, by generator** | | Generate PBR Textures | per object | 30 | So a scene is **30 + (per-object cost × objects)**: | Objects kept | Tripo H3.1 | Hunyuan 3D 3.1 Pro | Meshy 6, 7 or 7.1 | | ------------ | ---------- | ------------------ | ----------------- | | 10 | **730** | **830** | **880** | | 20 | **1,430** | **1,630** | **1,730** | Keeping 20 objects from one scene needs Artist Pro or above; see [Plans](#plans). **Check the generator before you run a large scene.** The same twenty-object scene is 1,430 credits on Tripo H3.1 and 1,730 on any Meshy model, for an identical selection. Running detection again, if the first decomposition isn't right, is another 20. How many objects you keep after detection is the main place you control the cost — see [Detecting & selecting objects](/marso-studio/scenes/detecting-and-selecting-objects.md). ## Plans Click your credit balance at the top of the screen to open **Settings → Usage & Billing**, and pick a plan on its **Plans** tab. Plans are billed monthly, in US dollars. | Plan | Price a month | Credits a month | Objects per scene | | -------------- | ------------- | --------------- | ----------------- | | **Free** | $0 | 400 | — | | **Artist** | $29 | 2,400 | 10 | | **Artist Pro** | $99 | 9,500 | 20 | | **Studio** | $399 | 40,000 | No limit | **Objects per scene** is how many objects one **Detect Objects** run can carry on to **Generate Reference Images (Group)**. If you select more, the object viewer tells you how many to deselect. See [Detecting & selecting objects](/marso-studio/scenes/detecting-and-selecting-objects.md). Every paid plan, and the trial, also includes these. The Free plan has none of them: * **Scene generation** — **Scene** projects, **Detect Objects**, and the **Generate Reference Images (Group)**, **Generate 3D Models (Group)** and **Generate PBR Textures (Group)** nodes * **Asset downloads** — every download in the app: images, 3D models, PBR textures and scenes. Viewing a result in the 3D viewer is open on every plan * **API and MCP access** — the Marso Studio API, Marso MCP and the plugins, and creating an API key. See [API access](/marso-studio/api/api-access.md) * **PBR texture API** and **Asset download API** — running PBR and downloading assets through the API * **Image editing** — the **Edit Image** and **Edit 3D Model** nodes * **Multiview generation** — the **Generate Multiview** node, and multi-view input on **Generate 3D Model** * **Custom polycount** — a custom face count on **Generate 3D Model** * **Sim-ready and Game-ready apps** — see [Apps](/marso-studio/workflows/apps.md) * **Commercial license** On the Free plan, clicking something your plan doesn't include opens **Plans** instead. For an **Enterprise** plan, get in touch through [Contact Support](/marso-studio/help-and-support/contact-support.md). ### Your trial New accounts start on **Free**. To use everything above, start a **14-day free trial** of the Artist plan: on the plan step the first time you sign in, or with **Start 14-day free trial** on the Artist card in **Plans**. The trial gives you Artist's features and its 2,400 credits. The trial needs a card. You pay $0 today, and on day 14 your card pays $29 for the Artist plan, then $29 each month until you cancel. To stop it, click **Cancel trial** on the **Plans** tab before day 14 and you pay nothing: you keep Artist until the trial ends, then move to **Free**. If the first payment fails, you move to **Free** too. While the trial runs, **Plans** shows a **Free trial** badge and the day it ends. You can't change plan during the trial: cancel it, or wait for it to end. Each account gets one trial, so if you've had a trial or a paid plan before, **Choose Artist** charges straight away. Organisations don't get a trial. ### Changing or cancelling your plan An upgrade starts straight away, with a new monthly billing period. A downgrade, or **Cancel subscription** on the **Plans** tab, takes effect at the end of the period you've paid for. Either way, the credits you already have stay until they expire. The **Billing** tab lists your invoices, and its **Manage payment details** button updates your card or billing address. ### When plan credits expire Plan credits, from the trial and from every monthly allowance, expire **two months** after they're granted. ## Buying credits Need more than your plan gives you? Buy a credit pack on the **Credits** tab of **Settings → Usage & Billing**: | Pack | Price | Roughly | | ----------------- | ----- | --------------------------------------------- | | **2,000 credits** | $20 | Two 10-object scenes on the default generator | | **5,000 credits** | $50 | Six 10-object scenes on the default generator | What a pack actually gets you depends on the generator, so read those as default-generator figures. Purchased credits last **12 months** from the day you buy them. ## Checking your balance and usage * Your credit balance is shown at the **top of the UI at all times**. * Hover a node's **Run** button to see what the step will cost before you run it. * An app shows the most a run can cost beside **Generate**. See [Apps](/marso-studio/workflows/apps.md). * For a full breakdown, open **Settings → Usage & Billing**: the **Credits** tab shows your balance and the **Usage** tab what you've spent. > Scene generation is the most expensive thing you can run, because it multiplies across every object you keep. Check your balance, your selected object count **and your 3D generator** before you start a large scene — see [Working with scene results](/marso-studio/scenes/working-with-scene-results.md) if a run stops partway. --- # 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.m-xr.com/marso-studio/reference/credits-and-billing.md?ask=&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.