visualize_model
Read-only
Render PNG stills of any STL, 3MF, OBJ, or SCAD file from up to six angles to inspect a model from all sides after each change and before printing.
Instructions
Still pictures of any 3D file from multiple camera angles — the still door, not the 3D stage.
FOR THE PERSON'S LOOK BEFORE A PRINT, OPEN THE STAGE: ``show_on_stage(file_path)`` puts a file that already exists — a mesh, or the sliced print file — on Kiln's interactive 3D stage, which the print gate asks for first (``issue_preview_token(door="stage")``). These renders are for checking a model yourself. When the user is signed in the result also carries a browser stage link (``viewer_url``), the door for a host that draws no panel.
INSPECTION-ONLY UNLESS THE STAGE DREW IT: the result's ``renderer`` says which look these pixels are. ``stage`` (the stage photographed) and ``stage_paint`` (the stage's look painted) are accepted by ``issue_preview_token(door="png")`` for print sign-off; a raw ``openscad`` render is not — it has no plate and none of the stage's lighting, and a person once approved the wrong colours from one. Use it to inspect, and sign off from the stage, the viewer link, or a stage still.
Universal visualization tool that works with ANY 3D file — STL, 3MF,
OBJ, or SCAD. Returns PNG images from 6 angles: isometric, front,
right, top, bottom, and back.
**Colored 3MF support:** Multicolor 3MF files (with per-face color
groups from BambuStudio, PrusaSlicer, or procedural textures) are
automatically rendered with per-face colors — no slicer needed to
see what the multicolor print will look like. Colorless 3MF and
STL/OBJ files render in uniform color via OpenSCAD as before.
Dark models get an adaptive lighter background for visibility.
Each view includes a ``quality_score`` and ``dark_material`` flag.
Use this to check a model from all sides — after each change, and
before printing.
**When to use this vs other preview tools:**
- ``show_on_stage`` — the interactive 3D stage on an existing file; what the person turns over before a print
- ``visualize_model`` — still renders of any file, 6 angles, to check it yourself
- ``preview_generated_model`` — after AI generation, includes bottom check
- ``visualize_model(angles=["isometric"])`` — one angle, quick check
Args:
file_path: Path to an STL, 3MF, OBJ, or SCAD file.
angles: Optional subset of angles to render. Valid values:
``isometric``, ``front``, ``right``, ``top``, ``bottom``, ``back``.
Defaults to all 6.
width: Image width in pixels (default 800).
height: Image height in pixels (default 600).
color: Hex color for the model (e.g. ``"#F72323"`` for red).
Defaults to neutral grey. Pass the filament color to see
a realistic preview matching the printed result.
Ignored for colored 3MF files (per-face colors used instead).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_path": "<file_path>"
},
"name": "visualize_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | Hex color for the model (e.g. ``"#F72323"`` for red). Defaults to neutral grey. Pass the filament color to see a realistic preview matching the printed result. Ignored for colored 3MF files (per-face colors used instead). Default: "". | |
| width | No | Image width in pixels (default 800). Default: 800. | |
| angles | No | Optional subset of angles to render. Valid values: ``isometric``, ``front``, ``right``, ``top``, ``bottom``, ``back``. Defaults to all 6. | |
| height | No | Image height in pixels (default 600). Default: 600. | |
| file_path | Yes | Path to an STL, 3MF, OBJ, or SCAD file. |