Output Formats

Supported Formats

Specify output_format on your generation request. All formats are delivered as a signed download URL in the job response.

Format MIME type Best for
STEP application/step Engineering CAD — import into Fusion 360, SolidWorks, FreeCAD, Onshape. Lossless B-rep geometry. Recommended default.
STL model/stl 3D printing (FDM, SLA, SLS). Triangle mesh; no parametric data or material info.
GLB model/gltf-binary Web viewers, AR/VR, Blender. Binary glTF with materials and per-part color.
3MF application/3mf Additive manufacturing. Richer than STL — includes material, color, scale, and print settings.

Note: SVG and DXF (2D projected drawings) are available in the Makistry web app but are not yet in the public API v1.

The brainstorm Object

Every successful job returns a brainstorm object alongside the download URL. This is Makistry's pre-generation design analysis — useful for displaying a human-readable summary of what was built, surfacing design suggestions, or building UI on top of the API.

Schema

{
  "project_name": "string",
  "key_features": ["string"],
  "design_components": ["string"],
  "optimal_geometry": "string",
  "material_recommendations": "string",
  "suggestions": ["string", "string", "string"]
}

Fields

Field Description
project_name Short human-readable name for the design
key_features List of functional features the model identified in the prompt
design_components List of distinct physical components in the design
optimal_geometry Brief description of the geometric approach used
material_recommendations Suggested materials for the intended use case
suggestions 2–3 follow-up ideas to improve or extend the design

Example

{
  "project_name": "Lens Cap — 60mm OD",
  "key_features": ["snap-fit retention ring", "52mm inner retention lip", "3mm wall thickness"],
  "design_components": ["cap body", "snap-fit ring"],
  "optimal_geometry": "Thin-wall cylindrical extrusion with inset radial lip and flexible snap ring",
  "material_recommendations": "PLA or ABS for FDM printing; PETG for chemical resistance",
  "suggestions": [
    "Add a small loop boss on the outer rim for a tether or lanyard",
    "Chamfer the outer edge for easier one-handed removal",
    "Add a textured grip band around the circumference"
  ]
}

Parameter Manifest (coming to public API v1)

Internally, Makistry's pipeline generates a dimensions_contract for every part — a structured map of all editable numeric parameters (dimensions, tolerances, angles) with valid min/max/step ranges. This powers the parametric slider UI in the Makistry web app, where users can tweak dimensions and instantly regenerate geometry without re-running the full LLM pipeline.

Public API support for reading and editing parameters is planned. The schema, for reference:

{
  "<symbol_name>": {
    "value": 60.0,
    "min": 30.0,
    "max": 150.0,
    "step": 1.0,
    "unit": "mm",
    "label": "Outer Diameter"
  }
}

Fields

Field Type Description
value number Current value used in the generated model
min number or null Minimum safe value
max number or null Maximum safe value
step number or null Recommended increment for UI sliders
unit string "mm", "deg", or "" (dimensionless)
label string Human-readable parameter name

Full example

{
  "outer_diameter":   { "value": 60.0, "min": 30.0, "max": 150.0, "step": 1.0,  "unit": "mm", "label": "Outer Diameter" },
  "wall_thickness":   { "value": 3.0,  "min": 1.0,  "max": 10.0,  "step": 0.5,  "unit": "mm", "label": "Wall Thickness" },
  "snap_ring_height": { "value": 4.0,  "min": 2.0,  "max": 8.0,   "step": 0.5,  "unit": "mm", "label": "Snap Ring Height" },
  "inner_lip_depth":  { "value": 2.5,  "min": 1.0,  "max": 6.0,   "step": 0.25, "unit": "mm", "label": "Inner Lip Depth" }
}

Watch the changelog for public API release of parameter editing.