Media
Convert a bitmap image into reconstruction-first audio designed to reappear in a spectrogram, then export the audio and a verification spectrogram preview together.
Call this tool from your code in three languages.
# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/image-to-spectrogram-audio' \
-H 'Content-Type: application/json' \
-d '{"filename":"imageFile.ext","contentType":"application/octet-stream","size":12345}'
# 2) PUT the file bytes directly to the presigned uploadUrl
curl -X PUT '<presigned uploadUrl>' \
--data-binary @/path/to/file.ext
# 3) Call the tool, passing the returned storageKey for each file field
curl -X POST 'https://api.elysiatools.com/en/api/tools/image-to-spectrogram-audio' \
-F 'imageFile=./public/processing/smoke-test-palette.png' \
-F 'durationSeconds=8' \
-F 'sampleRate=44100' \
-F 'outputFormat=wav' \
-F 'minFrequencyHz=200' \
-F 'maxFrequencyHz=12000' \
-F 'frequencyScale=linear' \
-F 'topRowHighFrequency=true' \
-F 'timeSlices=640' \
-F 'frequencyBins=160' \
-F 'resizeMode=stretch' \
-F 'contrast=1.25' \
-F 'threshold=0.05' \
-F 'verificationPalette=magma'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST https://api.elysiatools.com/en/api/tools/image-to-spectrogram-audio| Name | Type | Required | Description |
|---|---|---|---|
| imageFile | fileupload required | Yes | — |
| durationSeconds | number | No | — |
| sampleRate | select | No | — |
| outputFormat | select | No | — |
| minFrequencyHz | number | No | — |
| maxFrequencyHz | number | No | — |
| frequencyScale | select | No | — |
| topRowHighFrequency | checkbox | No | — |
| timeSlices | number | No | — |
| frequencyBins | number | No | — |
| resizeMode | select | No | — |
| contrast | number | No | — |
| threshold | number | No | — |
| verificationPalette | select | No | — |
HTML result
{
"result": "<div>Processed HTML content</div>",
"error": "Error message (optional)",
"message": "Notification message (optional)",
"metadata": {
"key": "value"
}
}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-image-to-spectrogram-audio": {
"name": "image-to-spectrogram-audio",
"description": "Convert a bitmap image into reconstruction-first audio designed to reappear in a spectrogram, then export the audio and a verification spectrogram preview together.",
"baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=image-to-spectrogram-audio",
"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": "image-to-spectrogram-audio",
"arguments": {
"imageFile": "./public/processing/smoke-test-palette.png",
"durationSeconds": 8,
"sampleRate": "44100",
"outputFormat": "wav",
"minFrequencyHz": 200,
"maxFrequencyHz": 12000,
"frequencyScale": "linear",
"topRowHighFrequency": true,
"timeSlices": 640,
"frequencyBins": 160,
"resizeMode": "stretch",
"contrast": 1.25,
"threshold": 0.05,
"verificationPalette": "magma"
}
}
}Questions or issues? Contact [email protected]