validate_and_prepare
Validate any 3D model for print readiness with format, mesh, watertight, auto-repair, and structural checks. Get a pass/fail report and printability score (0-100) with actionable recommendations.
Instructions
Comprehensive validation pipeline for any 3D model before printing.
Runs format check, mesh analysis, watertight check, auto-repair,
printability analysis, structural assessment, bed-fit check, and
(optionally) material-specific checks.
Returns a detailed pass/fail report with actionable recommendations
plus a numeric printability score (0-100).
Works with any model — AI-generated, downloaded from marketplaces,
or created in CAD. Every model passes Kiln's engineering review
before it touches your printer.
Each step is resilient — if a step's underlying module is unavailable
the step is skipped and the pipeline continues.
:param input_path: Path to a 3D model file (.stl, .3mf, .obj, .step, .glb).
:param printer_id: Optional printer model ID (e.g. "bambu_a1") for
bed-fit checking. If empty, bed-fit check is skipped.
:param material: Optional material name (e.g. "pla", "petg", "abs",
"asa", "tpu"). When provided, adds a material-specific check
for known print-quality risks. If empty, material check is skipped.
:returns: Dict with pass/fail status, per-check details, recommendations,
``printability_score`` (0-100), and ``score_breakdown``.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| material | No | ||
| input_path | Yes | ||
| printer_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||