Wiro - Trellis-2 3D Mesh Generator icon

Wiro - Trellis-2 3D Mesh Generator

Generate high-quality 3D meshes from images with Trellis-2 AI. Perfect for 3D modeling, gaming,

Wiro - Trellis-2 3D Mesh Generator

AI-generated

Overview

This node generates high-quality 3D meshes from input images using the Trellis-2 AI model provided by the Wiro API. It is useful for applications in 3D modeling, gaming, and other scenarios where converting 2D images into detailed 3D models is needed. For example, a user can input an image URL of an object, and the node will produce a 3D mesh with customizable resolution, texture size, and diffusion parameters.

Use Case Examples

  1. Generating a 3D model of a product from its photo for use in an online store.
  2. Creating game assets by converting character images into 3D meshes.
  3. Producing 3D printable models from 2D artwork.

Properties

Name Meaning
Input Image URL URL of the image to convert into a 3D mesh; the background is automatically removed if no alpha channel is present.
Resolution 3D generation resolution affecting speed and quality; options are 512 (fastest), 1024 (recommended), and 1536 (highest quality).
Seed Random seed for reproducible results; 0 means a random seed is chosen automatically.
Texture Size Resolution in pixels for the PBR texture map in the GLB export.
Decimation Target Target face count for GLB mesh decimation; higher values produce more detail but larger files and slower UV unwrapping.
Sparse Structure Steps Diffusion steps for the coarse 3D skeleton; more steps improve quality but slow down processing.
Sparse Structure Guidance Strength CFG strength for sparse structure; higher values make the output more faithful to the input image but may cause artifacts.
Sparse Structure Guidance Rescale Corrects over-saturation from high CFG; 0 disables correction, 1 enables full correction.
Sparse Structure Rescale T Timestep rescale for sparse structure; higher values allocate more time to early coarse steps.
Shape Slat Steps Diffusion steps for detailed 3D geometry; directly affects shape detail quality.
Shape Slat Strength CFG strength for shape generation; controls how closely geometry follows the input image.
Shape Slat Rescale CFG rescale for shape; slightly lower than sparse structure for more natural geometry.
Shape Slat Rescale T Timestep rescale for shape generation; lower than sparse structure for more uniform step distribution.
Tex Slat Steps Diffusion steps for PBR texture generation; directly affects texture quality.
Tex Slat Guidance Strength CFG strength for texture; default 1.0 means no guidance, as texture generation usually works best unguided.
Tex Slat Guidance Rescale CFG rescale for texture; default 0 disables it since guidance strength is already 1.0.
Tex Slat Rescale T Timestep rescale for texture generation.

Output

JSON

  • taskid - Identifier of the 3D mesh generation task.
  • url - URL to the generated 3D mesh resource if the task completed successfully.
  • status - Status of the task, e.g., 'completed' or 'failed'.

Dependencies

  • Wiro API with API key and secret for authentication

Troubleshooting

  • If the API response does not include a valid task ID or socket access token, the node throws an error indicating an invalid response from the Wiro API. Verify API credentials and network connectivity.
  • Task status codes '-1', '-2', '-3', '-4' indicate failure states; check input parameters and API limits.
  • Ensure the input image URL is accessible and points to a valid image file to avoid processing errors.

Links

Discussion