> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mint.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# Materials

> Generate and retrieve Materials and coordinated Material Packs.

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](/developers/api-overview#presets) 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`.

```json theme={null}
{
  "prompt": "Weathered green copper with subtle rain streaks",
  "name": "Weathered copper",
  "mode": "generate"
}
```

## 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](/developers/assets) routes.