Skip to main content
Use Materials for reusable surface maps. Use a Material Pack when several Materials should share one visual direction.

Generate a Material

Call POST /v1/materials:generate with prompt and optional name, generationPreset, mode, or one imageUrl. Mint derives a title when name is omitted; choose a preset for the desired speed, quality, and cost. mode can be generate, image_to_maps, or extract. Materials consume one image; they do not accept sourceImages or generationMode.

Generate a Material Pack

Call POST /v1/material-packs:generate with a shared prompt and 2–25 item plans. You can add styleGuide, itemCount, mode, or one shared imageUrl.

Retrieve Materials and files

Use GET /v1/materials/{materialId} or GET /v1/material-packs/{materialPackId}. For downloadable maps and packaged outputs, request the asset’s file list or manifest through the Assets routes.