3D
meshy-tools
Make a 3D model, give one a new surface, or carve a relief.
<!-- Generated by apps/docs/scripts/gen-tools.mjs. Do not edit here: the words live in apps/web/src/lib/tools/meshy.tool.json (agent, hint) and packages/shared/src/tools/setting-hints.ts. --> On the rail as **meshy-tools**. ## When to use it Making a textured 3D model from one photo, up to four views of an object or a few words; giving a 3D model new textures while its shape stays; or turning a photo into a relief, raised or carved in, sized in millimetres to print. ## When to reach for something else A busy photo or several objects in one make a muddled model. A new surface changes textures only, never the shape. A relief reads depth from one photo and has no colour, so it cannot make an object seen from every side. ## How to use it 1. Drop a picture onto the card's **Front** slot, from the board or your computer. 2. Drop a picture onto the card's **View 2** slot, from the board or your computer. 3. Drop a picture onto the card's **View 3** slot, from the board or your computer. 4. Drop a picture onto the card's **View 4** slot, from the board or your computer. 5. Drop a picture onto the card's **Front** slot, from the board or your computer. 6. Drop a picture onto the card's **View 2** slot, from the board or your computer. 7. Drop a picture onto the card's **View 3** slot, from the board or your computer. 8. Drop a picture onto the card's **View 4** slot, from the board or your computer. 9. Write what you want in **Prompt**. 10. Set **Detail** on the card. 11. Pick a mode on the card: **image-to-3d**, **text-to-3d**, **New surface**, **Relief**. 12. Pick a model in the pill at the top of the card, or keep **Meshy 7.1**. 13. Press **Run**. ## On the card | Control | What it does | Choices | | - | - | - | | Front | The picture the tool works from. Drop one from the board or your computer. | One picture | | Prompt | What you want, in your own words. The card sends it with your inputs. | Your words | | View 2 | | One picture | | View 3 | | One picture | | View 4 | | One picture | | Front | Optional picture of the material or style to copy. | One picture | | View 2 | Another view of the look you want, from a different side. Optional; more views help the texture fit all round. | One picture | | View 3 | Another view of the look you want, from a different side. Optional; more views help the texture fit all round. | One picture | | View 4 | Another view of the look you want, from a different side. Optional; more views help the texture fit all round. | One picture | | Detail | An extra pass that sharpens edges and fine surface detail. Ultra takes longer and costs a little more; 4K is the finest. | Standard, Ultra 2K, Ultra 4K | | 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 photo or up to four views Models in this mode: **Meshy 7.1**, **Meshy 7.1**. ### text-to-3d A few words become a model Models in this mode: **Meshy 7.1**. ### New surface New textures on a 3D model Models in this mode: **Meshy 7**. Settings this mode adds: | Setting | What it does | Choices | | - | - | - | | Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off | | Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K | ### Relief A photo carved into a relief Models in this mode: **Meshy Relief**. Settings this mode adds: | Setting | What it does | Choices | | - | - | - | | Size | | 20 to 250 mm | | Base | | 0.1 to 10 mm | | Cut away the background | | On or off | | Curve | | Flat, Outward, Inward | | Curve angle | | 10 to 180 ° | | Curve axis | | Side to side, Top to bottom | | Detail | | Light, Fine | ## Models The pill at the top of the card picks the model. **Meshy 7.1** is the one a new card starts on. | Model | Good for | | - | - | | [Meshy 7.1](#meshy-71) | The premium-texture single-image generator: the richest PBR maps here, close tracking of the reference, quad topology by default, 2K to 8K textures, an optional prompt and an Ultra pass; also the engine behind the Inflater. | | [Meshy 7.1](#meshy-71-1) | One object photographed from up to 4 angles becomes a fuller mesh than one image gives, with PBR maps, quad topology by default, 2K to 8K textures and baked lighting removed; the choice for asymmetric objects, vehicles and furniture. | | [Meshy 7.1](#meshy-71-2) | The premium-texture text-to-3D generator: a preview then a PBR refine gives base color, metallic, roughness and normal maps from a prompt alone, with symmetry control, an Ultra pass, a texture-only prompt and 2K to 8K textures. | | [Meshy 7](#meshy-7) | Gives any mesh a whole new surface with full PBR maps: describe the finish in a prompt, or hand it up to four views of the object so the sides one picture cannot show come from real reference. Base colour at 2K, 4K or natively generated 8K. | | [Meshy Relief](#meshy-relief) | A photo made into a printable relief: raised or carved in, shallow or deep, 20 to 250 mm across, cut to its outline or on a plate, flat or bent; a coin, a keychain, a plaque, a cameo, a carved panel. | ### Meshy 7.1 **Not the one for:** It is the slow, costly route at 5 to 10 minutes per run, so a quick shape check or a fast iteration loop is wasted on it; it takes one image, and several angles of the same object belong with the multi-image variant. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle | | Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 | | Keep the model's UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off | | Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off | | Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K | | Image Enhancement | Cleans up the input photos before building. | On or off | ### Meshy 7.1 **Not the one for:** The extra photos must be the same object under the same light and finish, differing only in viewpoint; shots from different sessions confuse it, the Ultra pass here stops at 2K, and a run takes around 5 minutes. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle | | Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 | | Keep the model's UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off | | Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off | | Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K | | Image Enhancement | Cleans up the input photos before building. | On or off | ### Meshy 7.1 **Not the one for:** It is the slow route at 5 to 15 minutes for both phases and the costliest text generator here; prompts cap at 600 characters, and a quick shape check or a visually literal prompt is better served by the default. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle | | Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 | | Keep the model's UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off | | Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off | | Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K | | Image Enhancement | Cleans up the input photos before building. | On or off | ### Meshy 7 **Not the one for:** Geometry is untouched, so it cannot fix or reshape a model. Two or more views switch to multi-view texturing and the typed prompt is ignored, and 8K costs more than 2K and 4K, which cost the same. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle | | Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 | | Keep the model's UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off | | Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off | | Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K | | Image Enhancement | Cleans up the input photos before building. | On or off | ### Meshy Relief **Not the one for:** It reads depth from a single photo and makes no colour or texture, so it is the wrong choice for an object seen from every side or for a textured model; those come from a photo-to-model generator. Behind the settings button: | Setting | What it does | Choices | | - | - | - | | Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle | | Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 | | Keep the model's UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off | | Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off | | Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K | | Image Enhancement | Cleans up the input photos before building. | On or off |On the rail as meshy-tools.
When to use it
Section titled “When to use it”Making a textured 3D model from one photo, up to four views of an object or a few words; giving a 3D model new textures while its shape stays; or turning a photo into a relief, raised or carved in, sized in millimetres to print.
When to reach for something else
Section titled “When to reach for something else”A busy photo or several objects in one make a muddled model. A new surface changes textures only, never the shape. A relief reads depth from one photo and has no colour, so it cannot make an object seen from every side.
How to use it
Section titled “How to use it”- Drop a picture onto the card’s Front slot, from the board or your computer.
- Drop a picture onto the card’s View 2 slot, from the board or your computer.
- Drop a picture onto the card’s View 3 slot, from the board or your computer.
- Drop a picture onto the card’s View 4 slot, from the board or your computer.
- Drop a picture onto the card’s Front slot, from the board or your computer.
- Drop a picture onto the card’s View 2 slot, from the board or your computer.
- Drop a picture onto the card’s View 3 slot, from the board or your computer.
- Drop a picture onto the card’s View 4 slot, from the board or your computer.
- Write what you want in Prompt.
- Set Detail on the card.
- Pick a mode on the card: image-to-3d, text-to-3d, New surface, Relief.
- Pick a model in the pill at the top of the card, or keep Meshy 7.1.
- Press Run.
On the card
Section titled “On the card”| Control | What it does | Choices |
|---|---|---|
| Front | The picture the tool works from. Drop one from the board or your computer. | One picture |
| Prompt | What you want, in your own words. The card sends it with your inputs. | Your words |
| View 2 | One picture | |
| View 3 | One picture | |
| View 4 | One picture | |
| Front | Optional picture of the material or style to copy. | One picture |
| View 2 | Another view of the look you want, from a different side. Optional; more views help the texture fit all round. | One picture |
| View 3 | Another view of the look you want, from a different side. Optional; more views help the texture fit all round. | One picture |
| View 4 | Another view of the look you want, from a different side. Optional; more views help the texture fit all round. | One picture |
| Detail | An extra pass that sharpens edges and fine surface detail. Ultra takes longer and costs a little more; 4K is the finest. | Standard, Ultra 2K, Ultra 4K |
| 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 photo or up to four views
Models in this mode: Meshy 7.1, Meshy 7.1.
text-to-3d
Section titled “text-to-3d”A few words become a model
Models in this mode: Meshy 7.1.
New surface
Section titled “New surface”New textures on a 3D model
Models in this mode: Meshy 7.
Settings this mode adds:
| Setting | What it does | Choices |
|---|---|---|
| Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off |
| Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K |
Relief
Section titled “Relief”A photo carved into a relief
Models in this mode: Meshy Relief.
Settings this mode adds:
| Setting | What it does | Choices |
|---|---|---|
| Size | 20 to 250 mm | |
| Base | 0.1 to 10 mm | |
| Cut away the background | On or off | |
| Curve | Flat, Outward, Inward | |
| Curve angle | 10 to 180 ° | |
| Curve axis | Side to side, Top to bottom | |
| Detail | Light, Fine |
Models
Section titled “Models”The pill at the top of the card picks the model. Meshy 7.1 is the one a new card starts on.
| Model | Good for |
|---|---|
| Meshy 7.1 | The premium-texture single-image generator: the richest PBR maps here, close tracking of the reference, quad topology by default, 2K to 8K textures, an optional prompt and an Ultra pass; also the engine behind the Inflater. |
| Meshy 7.1 | One object photographed from up to 4 angles becomes a fuller mesh than one image gives, with PBR maps, quad topology by default, 2K to 8K textures and baked lighting removed; the choice for asymmetric objects, vehicles and furniture. |
| Meshy 7.1 | The premium-texture text-to-3D generator: a preview then a PBR refine gives base color, metallic, roughness and normal maps from a prompt alone, with symmetry control, an Ultra pass, a texture-only prompt and 2K to 8K textures. |
| Meshy 7 | Gives any mesh a whole new surface with full PBR maps: describe the finish in a prompt, or hand it up to four views of the object so the sides one picture cannot show come from real reference. Base colour at 2K, 4K or natively generated 8K. |
| Meshy Relief | A photo made into a printable relief: raised or carved in, shallow or deep, 20 to 250 mm across, cut to its outline or on a plate, flat or bent; a coin, a keychain, a plaque, a cameo, a carved panel. |
Meshy 7.1
Section titled “Meshy 7.1”Not the one for: It is the slow, costly route at 5 to 10 minutes per run, so a quick shape check or a fast iteration loop is wasted on it; it takes one image, and several angles of the same object belong with the multi-image variant.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle |
| Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 |
| Keep the model’s UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off |
| Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off |
| Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K |
| Image Enhancement | Cleans up the input photos before building. | On or off |
Meshy 7.1
Section titled “Meshy 7.1”Not the one for: The extra photos must be the same object under the same light and finish, differing only in viewpoint; shots from different sessions confuse it, the Ultra pass here stops at 2K, and a run takes around 5 minutes.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle |
| Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 |
| Keep the model’s UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off |
| Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off |
| Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K |
| Image Enhancement | Cleans up the input photos before building. | On or off |
Meshy 7.1
Section titled “Meshy 7.1”Not the one for: It is the slow route at 5 to 15 minutes for both phases and the costliest text generator here; prompts cap at 600 characters, and a quick shape check or a visually literal prompt is better served by the default.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle |
| Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 |
| Keep the model’s UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off |
| Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off |
| Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K |
| Image Enhancement | Cleans up the input photos before building. | On or off |
Meshy 7
Section titled “Meshy 7”Not the one for: Geometry is untouched, so it cannot fix or reshape a model. Two or more views switch to multi-view texturing and the typed prompt is ignored, and 8K costs more than 2K and 4K, which cost the same.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle |
| Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 |
| Keep the model’s UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off |
| Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off |
| Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K |
| Image Enhancement | Cleans up the input photos before building. | On or off |
Meshy Relief
Section titled “Meshy Relief”Not the one for: It reads depth from a single photo and makes no colour or texture, so it is the wrong choice for an object seen from every side or for a textured model; those come from a photo-to-model generator.
Behind the settings button:
| Setting | What it does | Choices |
|---|---|---|
| Topology | The pattern the surface is built from. Quads (four-sided) are cleaner for editing and animation; triangles are the raw default. | Quad, Triangle |
| Target Polycount | Roughly how many surfaces the finished model should have. More is more detail and a heavier file. | 100 to 300000 |
| Keep the model’s UVs | Keeps the model’s existing surface layout instead of redoing it. | On or off |
| Material maps (PBR) | Generates realistic surface materials (how light, shine, and bumps behave), not just a flat color. On some models this adds to the cost. | On or off |
| Texture Resolution | How sharp the model’s surface art is. Higher looks crisper up close but makes a heavier file. | 2K, 4K, 8K |
| Image Enhancement | Cleans up the input photos before building. | On or off |