Media
Apply granular synthesis to the audio
Call this tool from your code in three languages.
# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/audio-granulator' \
-F 'file=@/path/to/audioFile.ext'
# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/en/api/tools/audio-granulator' \
-F 'audioFile=/path/to/file.ext' \
-F 'grainSize=50' \
-F 'density=30' \
-F 'spray=20' \
-F 'pitch=1' \
-F 'randomness=0.4' \
-F 'overlap=0.3' \
-F 'mix=0.75' \
-F 'outputFormat=mp3'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/audio-granulator| Name | Type | Required | Description |
|---|---|---|---|
| audioFile | fileupload required | Yes | — |
| grainSize | range | No | Duration of each audio grain. Smaller values = more fragmented texture. |
| density | range | No | How many grains per second. Higher values = denser, more continuous sound. |
| spray | range | No | Random timing variation between grains. Higher values = more scattered, unpredictable texture. |
| pitch | range |
Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-audio-granulator": {
"name": "audio-granulator",
"description": "Apply granular synthesis to the audio",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=audio-granulator",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "audio-granulator",
"arguments": {
"audioFile": "https://example.com/file.ext",
"grainSize": 50,
"density": 30,
"spray": 20,
"pitch": 1,
"randomness": 0.4,
"overlap": 0.3,
"mix": 0.75,
"outputFormat": "mp3"
}
}
}| No |
| Pitch modification of grains. Can create harmonic or dissonant clusters. |
| randomness | range | No | Overall randomization of grain parameters. Higher values = more chaotic, evolving texture. |
| overlap | range | No | Amount of overlap between grains. Higher values = smoother, more blended texture. |
| mix | range | No | Balance between dry (original) and wet (granular) signal. |
| outputFormat | select | No | — |
File result
{
"filePath": "/public/processing/randomid.ext",
"fileName": "output.ext",
"contentType": "application/octet-stream",
"size": 1024,
"metadata": {
"key": "value"
},
"error": "Error message (optional)",
"message": "Notification message (optional)"
}Questions or issues? Contact [email protected]