Elysia Tools Docs
EN
Language
ZHDERUPTENFRES
Back to site
Browse tools

Media

Audio Vocoder

Turn a voice or instrument recording into a robotic audio effect with a built-in carrier. Set the blend and export as MP3, WAV, or five other audio formats.

file· File resultOpen tool

Quick start

Call this tool from your code in three languages.

cURL
# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'https://api.elysiatools.com/api/upload/presign/audio-vocoder' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"modulatorFile.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/audio-vocoder' \
  -F 'modulatorFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'carrierType=synth' \
  -F 'carrierFreq=120' \
  -F 'carrierWaveform=square' \
  -F 'bands=12' \
  -F 'analysis=35' \
  -F 'mix=0.65' \
  -F 'outputFormat=wav'

© 2026 Elysia Tools. Developer documentation.

Back to siteBrowse tools

API reference

Send a POST request with your inputs as JSON. File parameters require a separate upload first.

Endpoint

HTTP
POST https://api.elysiatools.com/en/api/tools/audio-vocoder

Parameters

NameTypeRequiredDescription
modulatorFilefileupload requiredYesOne voice or instrument recording, up to 100 MB. The audio is uploaded for server-side processing.
carrierTypeselectNoChoose a built-in sound source: synth, white noise, pulse train, or harmonic stack.
carrierFreqnumberNoFundamental frequency for synth, pulse, and harmonic carriers. White noise does not use this setting.
carrierWaveformselectNoOscillator shape for the synthesized carrier only.
bandsnumberNoNumber of bands from about 100 Hz to 5 kHz. Use a whole number from 4 to 32.
analysisnumberNoControls smoothing of band amplitude. Lower values follow changes more quickly.
mixrangeNo0 uses the original signal, 1 uses only the vocoder effect, and intermediate values blend the two.
outputFormatselectNo—
File-type parameters must be uploaded first via POST /upload/audio-vocoder, then the returned filePath is passed to the corresponding file field.

Response format

File result

JSON
{
  "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)"
}

MCP integration

Add this tool to your Model Context Protocol server so AI agents can list and call it.

Server configuration

Add this block to your MCP client configuration:

mcp.json
{
  "mcpServers": {
    "elysiatools-audio-vocoder": {
      "name": "audio-vocoder",
      "description": "Turn a voice or instrument recording into a robotic audio effect with a built-in carrier. Set the blend and export as MP3, WAV, or five other audio formats.",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=audio-vocoder",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

List available tools

After connecting to the SSE endpoint, list the exposed tools:

tools/list
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}

Call this tool

Invoke the tool by its id, passing arguments built from its parameters:

tools/call
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "audio-vocoder",
    "arguments": {
  "modulatorFile": "https://example.com/file.ext",
  "carrierType": "synth",
  "carrierFreq": 120,
  "carrierWaveform": "square",
  "bands": 12,
  "analysis": 35,
  "mix": 0.65,
  "outputFormat": "wav"
}
  }
}
Chain multiple tools in one session with a comma-separated toolId list, e.g. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max 20).
File parameters accept a public file URL only (https://…). Local paths, data: URIs, and Base64 strings are not supported.

Questions or issues? Contact admin@elysiatools.com

Browse tools
Open tool