3D
trellis-tools
A 3D model from one image, or new textures on a model.
<!-- Generated by apps/docs/scripts/gen-tools.mjs. Do not edit here: the words live in apps/web/src/lib/tools/trellis.tool.json (agent, hint) and packages/shared/src/tools/setting-hints.ts. --> On the rail as **trellis-tools**. ## When to use it Making a 3D model from one image, as a quick draft or a fuller model, or giving a 3D model new textures painted from one reference picture while its shape stays. ## When to reach for something else It takes no written direction: one image or one picture is the whole instruction, so a side the image does not show is invented. Retexture paints colour only, so a surface that must answer light needs a follow-up pass. ## How to use it 1. Drop a picture onto the card's **Image** slot, from the board or your computer. 2. Drop a picture onto the card's **Reference** slot, from the board or your computer. 3. Set **Resolution** on the card. 4. Pick a mode on the card: **image-to-3d**, **retexture**. 5. Pick a model in the pill at the top of the card, or keep **Trellis 2**. 6. Press **Run**. ## On the card | Control | What it does | Choices | | - | - | - | | Image | The picture the tool works from. Drop one from the board or your computer. | One picture | | Reference | | One picture | | Resolution | How big and detailed the result is. Higher looks sharper but costs more and takes longer. | 512, 1024, 1536 | | Run | Starts the run. The number on it is what this run costs in credits, worked out before you press. | | | ×1 | Runs the card several times in a row with the same settings. | 1 to 99 | ## Modes ### image-to-3d One image becomes a 3D model Models in this mode: **Trellis 2**, **Trellis 1**. ### retexture New textures on a 3D model Models in this mode: **Trellis 2**. ## Models The pill at the top of the card picks the model. **Trellis 2** is the one a new card starts on. | Model | Good for | | - | - | | [Trellis 2](#trellis-2) | The everyday all-rounder for image-to-3D: a textured mesh in about 30 seconds with up to 1536p resolution, decimation and remeshing for clean topology, and the generator that applies a trained 3D style from your own models. | | [Trellis 1](#trellis-1) | The quick, affordable single-image generator and the default for a first look: consistent, repeatable output with clean UV maps in about 35 seconds, to find out whether a picture reads in 3D before spending on a careful mesh. | | [Trellis 2](#trellis-2-1) | Painting a model's surface from one reference picture: the style, material and palette all come from that image, with texture size up to 4096px, sampling steps and a guidance strength. | ### Trellis 2 **Not the one for:** It ignores the prompt and returns a base color map only, no PBR set; with a 3D style active the resolution is fixed, so raise Detail instead, and finer geometry or richer materials call for the HD or premium-texture generators. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Detail | How many refinement passes to take. More adds a little detail but is slower. | Fast, Standard, High | | Texture Size | How sharp the surface art is. Bigger looks crisper up close but is a heavier file. | 1024px, 2048px, 4096px | | Remesh | Rebuilds the surface into a cleaner, more even grid that is easier to edit, texture, and animate. | On or off | ### Trellis 1 **Not the one for:** It ignores the prompt, returns a mesh with a base color map only (no normal or metallic-roughness maps), and gives less detail than Trellis 2; take a shape worth keeping to a high-quality engine afterwards. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Randomize Seed | When on, uses a new random starting point each run so every result comes out different. | On or off | | Sparse Structure Steps | Advanced: refinement passes for the rough-shape stage. The default is fine for almost everyone. | 1 to 50 | | Sparse Structure Guidance | Advanced: how closely the rough-shape stage follows the input. The default is fine. | 0 to 10 | | Latent Steps | Advanced: refinement passes for the fine-detail stage. The default is fine for almost everyone. | 1 to 50 | | Latent Guidance | Advanced: how closely the fine-detail stage follows the input. The default is fine. | 0 to 10 | | Mesh Simplify | How aggressively to thin out the surface afterward to lighten the file. | 0.9 to 0.98 | | Texture Size | | 512 to 2048 | ### Trellis 2 **Not the one for:** There is no prompt, so the reference is the whole instruction; it returns base colour only (no roughness, metallic or normal map), and a mesh without UVs needs unwrapping first. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Texture Size | How sharp the surface art is. Bigger looks crisper up close but is a heavier file. | 1024px, 2048px, 4096px | | Sampling Steps | | 1 to 50 | | Seed | The starting dice roll. The same seed and settings give the same result every time; change it for a fresh variation, or leave it at -1 for a new random one. | A number |On the rail as trellis-tools.
When to use it
Section titled “When to use it”Making a 3D model from one image, as a quick draft or a fuller model, or giving a 3D model new textures painted from one reference picture while its shape stays.
When to reach for something else
Section titled “When to reach for something else”It takes no written direction: one image or one picture is the whole instruction, so a side the image does not show is invented. Retexture paints colour only, so a surface that must answer light needs a follow-up pass.
How to use it
Section titled “How to use it”- Drop a picture onto the card’s Image slot, from the board or your computer.
- Drop a picture onto the card’s Reference slot, from the board or your computer.
- Set Resolution on the card.
- Pick a mode on the card: image-to-3d, retexture.
- Pick a model in the pill at the top of the card, or keep Trellis 2.
- Press Run.
On the card
Section titled “On the card”| Control | What it does | Choices |
|---|---|---|
| Image | The picture the tool works from. Drop one from the board or your computer. | One picture |
| Reference | One picture | |
| Resolution | How big and detailed the result is. Higher looks sharper but costs more and takes longer. | 512, 1024, 1536 |
| Run | Starts the run. The number on it is what this run costs in credits, worked out before you press. | |
| ×1 | Runs the card several times in a row with the same settings. | 1 to 99 |
image-to-3d
Section titled “image-to-3d”One image becomes a 3D model
Models in this mode: Trellis 2, Trellis 1.
retexture
Section titled “retexture”New textures on a 3D model
Models in this mode: Trellis 2.
Models
Section titled “Models”The pill at the top of the card picks the model. Trellis 2 is the one a new card starts on.
| Model | Good for |
|---|---|
| Trellis 2 | The everyday all-rounder for image-to-3D: a textured mesh in about 30 seconds with up to 1536p resolution, decimation and remeshing for clean topology, and the generator that applies a trained 3D style from your own models. |
| Trellis 1 | The quick, affordable single-image generator and the default for a first look: consistent, repeatable output with clean UV maps in about 35 seconds, to find out whether a picture reads in 3D before spending on a careful mesh. |
| Trellis 2 | Painting a model’s surface from one reference picture: the style, material and palette all come from that image, with texture size up to 4096px, sampling steps and a guidance strength. |
Trellis 2
Section titled “Trellis 2”Not the one for: It ignores the prompt and returns a base color map only, no PBR set; with a 3D style active the resolution is fixed, so raise Detail instead, and finer geometry or richer materials call for the HD or premium-texture generators.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Detail | How many refinement passes to take. More adds a little detail but is slower. | Fast, Standard, High |
| Texture Size | How sharp the surface art is. Bigger looks crisper up close but is a heavier file. | 1024px, 2048px, 4096px |
| Remesh | Rebuilds the surface into a cleaner, more even grid that is easier to edit, texture, and animate. | On or off |
Trellis 1
Section titled “Trellis 1”Not the one for: It ignores the prompt, returns a mesh with a base color map only (no normal or metallic-roughness maps), and gives less detail than Trellis 2; take a shape worth keeping to a high-quality engine afterwards.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Randomize Seed | When on, uses a new random starting point each run so every result comes out different. | On or off |
| Sparse Structure Steps | Advanced: refinement passes for the rough-shape stage. The default is fine for almost everyone. | 1 to 50 |
| Sparse Structure Guidance | Advanced: how closely the rough-shape stage follows the input. The default is fine. | 0 to 10 |
| Latent Steps | Advanced: refinement passes for the fine-detail stage. The default is fine for almost everyone. | 1 to 50 |
| Latent Guidance | Advanced: how closely the fine-detail stage follows the input. The default is fine. | 0 to 10 |
| Mesh Simplify | How aggressively to thin out the surface afterward to lighten the file. | 0.9 to 0.98 |
| Texture Size | 512 to 2048 |
Trellis 2
Section titled “Trellis 2”Not the one for: There is no prompt, so the reference is the whole instruction; it returns base colour only (no roughness, metallic or normal map), and a mesh without UVs needs unwrapping first.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Texture Size | How sharp the surface art is. Bigger looks crisper up close but is a heavier file. | 1024px, 2048px, 4096px |
| Sampling Steps | 1 to 50 | |
| Seed | The starting dice roll. The same seed and settings give the same result every time; change it for a fresh variation, or leave it at -1 for a new random one. | A number |