generate_mesh
Create a textured 3D GLB mesh from one object image or a text prompt, including optional multi-view input and retopology for game-ready assets.
Instructions
Generate a textured 3D mesh (GLB with PBR materials) from an image of one object.
Give input_image (a local path), or give only prompt to first generate a reference image with the image model (a plain background suffix is added) and then mesh it. Default model: TRELLIS.2 with shape resolution 1024, 2048 px textures, 300k faces. Multi-view: also give left_image, back_image and/or right_image (views 90 degrees apart at the same scale, input_image being the front) to use Pixal3D multi-view instead. framing (multi-view only): "crop" (default) crops each view to its own outline, which suits figures; it stretches the side views of objects wider from the front than the side. "as_framed" uses square views exactly as given (object centred, about 1/1.1 of the frame at its widest, one scale for all views, as from a 3D render rig at 20 degrees horizontal FOV). remove_background=False uses the image's own alpha channel instead of BiRefNet. retopo_faces (for example 10000): also make a game weight copy with retopologize_mesh (retopo_method "quad" or "decimate"); the result's "retopo" entry has its path. retopo_lods (for example [10000, 3000, 800]) makes a LOD chain instead, as retopologize_mesh's lods. For a plain triangle mesh at a given size, face_count alone does it inside the generation. Returns the GLB path, the reference image path when one was generated, seed, settings and timings.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "generate_mesh"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | ||
| model | No | ||
| prompt | No | ||
| framing | No | crop | |
| back_image | No | ||
| face_count | No | ||
| left_image | No | ||
| output_dir | No | ||
| resolution | No | ||
| input_image | No | ||
| retopo_lods | No | ||
| right_image | No | ||
| retopo_faces | No | ||
| texture_size | No | ||
| retopo_method | No | quad | |
| remove_background | No | ||
| idle_timeout_seconds | No |