mint:generate:start
Start Audio Generation
start_audio_generation
Starts final-only playable audio generation for sound effects, UI sounds, ambience, or music.
Parameters
Input schema generated from the registry. Required parameters are tagged.
- promptrequired
string
- audio_kindrequired
"sound_effect" | "general_audio"
- duration_seconds
number
- display_name_hint
string
- chat_id
string
- 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": "A crisp coin pickup sound for a cozy mobile game UI.",
"audio_kind": "sound_effect",
"duration_seconds": 2,
"display_name_hint": "Coin Pickup"
}Example response
{
"status": "queued",
"assetType": "audio",
"assetId": "audcoinpickup123",
"chatId": "j572z3a4b5c6d7e8f9g0h1i2j3",
"chatUrl": "https://mint.gg/chat/j572z3a4b5c6d7e8f9g0h1i2j3",
"chatCreated": true,
"pollIntervalMs": 30000,
"summary": "Audio generation started.",
"lifecycleStatus": "running",
"audioKind": "sound_effect",
"durationSeconds": 2,
"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": "audio",
"asset_id": "audcoinpickup123",
"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": "audio",
"asset_id": "audcoinpickup123"
}
},
{
"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": "audio",
"asset_id": "audcoinpickup123"
}
},
{
"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": "audio",
"asset_id": "audcoinpickup123",
"artifact_id": "<artifact_id>"
}
}
]
}Use cases
- Generate a sound effect, UI sound, short ambience, or music loop from text.
- Wait for final readiness, then fetch the generated audio file through artifact tools.