Remesh
Re-decimate a mesh to a new triangle count without regenerating the texture.
Produce a new triangle count from an existing mesh - a Detailer or a Sculptor result - without regenerating the texture. Fast. A Detailer pass is not a prerequisite: you can remesh a Sculptor output directly.
The quick way to simplify a mesh
To lighten a model you already have, remesh it rather than re-running the
Detailer at a lower decimation_target. Remesh reuses the existing
geometry and texture, so it's much faster and cheaper - and you keep the same model,
just lighter, instead of generating a new one.
Re-decimate a mesh
POST /api/v1/detailer/remesh
Requires API key.
Two modes:
- Whole-mesh (default) — leave
focus_on_node_namesempty and the newdecimation_targetis spread across every part of the model. - Part-focused — pass one or more part names in
focus_on_node_namesand the budget is applied only to those parts. Every other part keeps its current resolution, so you can lighten (or refine) a single component without touching the rest.
Whole-mesh remesh works directly on a Sculptor output - you do not need to
run the Detailer first. Part-focused remesh is the only exception: it needs
per-part data, so it is only supported on part-preserving Detailer results
(created with preserve_parts: true). A merged or Sculptor-based parent has no
per-part data and returns 400 for part-focused mode.
Request Body
| Name | Type | Description |
|---|---|---|
parent_submission_id | string (required) | ID of a completed Detailer or Sculptor submission. Whole-mesh remesh accepts either; part-focused remesh requires a part-preserving Detailer. |
decimation_target | integer | Target triangle count. 1,000–200,000. Default: 200000. Whole-mesh when focus_on_node_names is empty; otherwise the budget applied to each focused part. |
remesh | boolean | Run quad remeshing before decimation. Default: true. |
focus_on_node_names | string[] | Restrict the new budget to these named parts. Empty = whole mesh. Part-preserving detailer parents only. |
project_id | string | Assign to a project. |