mint:generate:start
Start Material Generation
start_material_generation
Starts standalone PBR material generation or material map extraction.
Parameters
Input schema generated from the registry. Required parameters are tagged.
- prompt
string
- mode
"generate" | "image_to_maps" | "extract"
- display_name_hint
string
- chat_id
string
- image_url
string (URL)
- source_url
string (URL)
- contextrequired
string
Describe the user's goal and why this tool helps in 15-25 words. Do not include credentials, personal data, identifiers, URLs, emails, or account addresses.
Example request
{
"prompt": "Mossy stone wall blocks with damp crevices and subtle lichen.",
"mode": "generate",
"display_name_hint": "Mossy Stone"
}Example response
{
"status": "queued",
"assetType": "material",
"assetId": "matmossystone123",
"chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
"chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
"chatCreated": true,
"pollIntervalMs": 30000,
"summary": "Material run queued.",
"approvalRequiredForFinalGeneration": false,
"nextSteps": [
{
"tool": "wait_for_status",
"action": "wait_for_final",
"description": "Poll until Mint reports final output eligibility before trying to use files in a code project.",
"input": {
"asset_type": "material",
"asset_id": "matmossystone123",
"until_stage": "final"
}
},
{
"tool": "list_asset_artifacts",
"action": "list_downloadable_artifacts",
"description": "After the asset reaches final, list downloadable artifacts and choose a downloadable artifact_id.",
"input": {
"asset_type": "material",
"asset_id": "matmossystone123"
}
},
{
"tool": "get_asset_artifact_manifest",
"action": "fetch_artifact_manifest",
"description": "Fetch a ready-to-copy artifact manifest with durable downloadUrls, suggested project paths, and loader hints for code-project imports.",
"input": {
"asset_type": "material",
"asset_id": "matmossystone123"
}
},
{
"tool": "get_asset_artifact",
"action": "fetch_artifact_download_url",
"description": "Fetch the chosen artifact to receive mintUrl plus downloadUrl for curl, R3F loaders, browser audio, or game runtime code.",
"input": {
"asset_type": "material",
"asset_id": "matmossystone123",
"artifact_id": "<artifact_id>"
}
}
]
}Use cases
- Create a standalone seamless material or PBR map set.
- Convert a source texture image into material maps.
Related Mint workflow
AI PBR Material generation →