apply_decoration
Reapply perfected decorations to any 3D model using saved settings. Automatically resolves depth, mode, and style from a previously proven recipe.
Instructions
Apply a saved decoration to a new model — proven settings, one call.
Loads a previously saved decoration and applies it to the target
model using the exact settings that worked before. Automatically
resolves depth, mode, and image style from the proven recipe.
This is the magic tool — decorations that took many iterations
to perfect can be replayed on any model in one call.
:param name: Decoration name or slug.
:param model_path: Path to the target model (STL or OBJ).
:param material: Override material (empty = use proven or detect
from printer).
:param face: Which face to decorate (auto, top, bottom, etc.).
:param printer_id: Optional printer ID for material detection.
:returns: Dict with decorated model path and settings used.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| face | No | auto | |
| name | Yes | ||
| material | No | ||
| model_path | Yes | ||
| printer_id | No |