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, manufacturing, and simulations. Universal file format and 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"
  ]
}