Media

Drum-Replacer

Erkennt Kick-, Snare- und Hi-Hat-Hits in einer Drumspur oder einem kompletten Mix und legt sie mit eigenen Samples darüber oder ersetzt sie.

file· DateiergebnisWerkzeug öffnen

Schnellstart

Rufen Sie dieses Werkzeug aus Ihrem Code in drei Sprachen auf.

cURL

# 1) Request a presigned URL → returns { uploadUrl, storageKey }
curl -X POST 'http://127.0.0.1:3003/api/upload/presign/drum-replacer' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"audioFile.ext","contentType":"application/octet-stream","size":12345}'
curl -X POST 'http://127.0.0.1:3003/api/upload/presign/drum-replacer' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"kickSample.ext","contentType":"application/octet-stream","size":12345}'
curl -X POST 'http://127.0.0.1:3003/api/upload/presign/drum-replacer' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"snareSample.ext","contentType":"application/octet-stream","size":12345}'
curl -X POST 'http://127.0.0.1:3003/api/upload/presign/drum-replacer' \
  -H 'Content-Type: application/json' \
  -d '{"filename":"hatSample.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 'http://127.0.0.1:3003/de/api/tools/drum-replacer' \
  -F 'audioFile=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'targets=kick,snare,hats' \
  -F 'kickSample=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'snareSample=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'hatSample=uploads/2026/01/01/your-tool-1700000000000-abc123.ext' \
  -F 'blendMode=layer' \
  -F 'sampleLevel=70' \
  -F 'duckDepthDb=12' \
  -F 'sensitivity=medium' \
  -F 'outputFormat=wav'

API-Referenz

Senden Sie eine POST-Anfrage mit Ihren Eingaben als JSON. Dateiparameter erfordern einen vorherigen Upload.

Endpunkt

HTTP

POST http://127.0.0.1:3003/de/api/tools/drum-replacer

Parameter

Name	Typ	Erforderlich	Beschreibung
audioFile	fileUpload nötig	Ja	—
targets	select	Ja	—
kickSample	fileUpload nötig	Nein	—
snareSample	fileUpload nötig	Nein	—
hatSample	fileUpload nötig	Nein	—
blendMode	select	Ja	—
sampleLevel	number	Nein	—
duckDepthDb	number	Nein	—
sensitivity	select	Ja	—
outputFormat	select	Ja	—

Dateiparameter müssen zuerst per POST /upload/drum-replacer hochgeladen werden; der zurückgegebene filePath wird dann an das entsprechende Feld übergeben.

Antwortformat

Dateiergebnis

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

Fügen Sie dieses Werkzeug Ihrem Model-Context-Protocol-Server hinzu, damit KI-Agenten es auflisten und aufrufen können.

Serverkonfiguration

Fügen Sie diesen Block Ihrer MCP-Client-Konfiguration hinzu:

mcp.json

{
  "mcpServers": {
    "elysiatools-drum-replacer": {
      "name": "drum-replacer",
      "description": "Erkennt Kick-, Snare- und Hi-Hat-Hits in einer Drumspur oder einem kompletten Mix und legt sie mit eigenen Samples darüber oder ersetzt sie.",
      "baseUrl": "http://127.0.0.1:3003/mcp/sse?toolId=drum-replacer",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Verfügbare Werkzeuge auflisten

Nach dem Verbinden mit dem SSE-Endpunkt listen Sie die bereitgestellten Werkzeuge auf:

tools/list

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

Dieses Werkzeug aufrufen

Rufen Sie das Werkzeug über seine ID auf; Argumente werden aus seiner Parameterliste gebildet:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "drum-replacer",
    "arguments": {
  "audioFile": "https://example.com/file.ext",
  "targets": [
    "kick",
    "snare",
    "hats"
  ],
  "kickSample": "https://example.com/file.ext",
  "snareSample": "https://example.com/file.ext",
  "hatSample": "https://example.com/file.ext",
  "blendMode": "layer",
  "sampleLevel": 70,
  "duckDepthDb": 12,
  "sensitivity": "medium",
  "outputFormat": "wav"
}
  }
}

Verketten Sie mehrere Werkzeuge in einer Sitzung mit einer kommagetrennten toolId-Liste, z. B. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (max. 20).

Dateiparameter akzeptieren ausschließlich eine öffentliche Datei-URL (https://…). Lokale Pfade, data:-URIs und Base64-Zeichenfolgen werden nicht unterstützt.

Fragen oder Probleme? Kontakt: [email protected]