Media

Filtro Espectral Áudio

Filtra áudio baseado conteúdo espectral

file· Resultado de arquivoAbrir ferramenta

Início rápido

Chame esta ferramenta a partir do seu código em três idiomas.

cURL

# 1) Upload each file first → returns { filePath }
curl -X POST 'https://api.elysiatools.com/upload/audio-spectral-filter' \
  -F 'file=@/path/to/audioFile.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/pt/api/tools/audio-spectral-filter' \
  -F 'audioFile=/path/to/file.ext' \
  -F 'filterType=enhance' \
  -F 'lowFreq=100' \
  -F 'lowGain=0' \
  -F 'midFreq=1000' \
  -F 'midGain=3' \
  -F 'highFreq=5000' \
  -F 'highGain=2' \
  -F 'sharpness=0.5' \
  -F 'resonance=0.3' \
  -F 'mix=0.85' \
  -F 'outputFormat=mp3'

Referência da API

Envie uma requisição POST com suas entradas em JSON. Parâmetros do tipo arquivo exigem upload prévio.

Endpoint

HTTP

POST https://api.elysiatools.com/pt/api/tools/audio-spectral-filter

Parâmetros

Nome	Tipo	Obrigatório	Descrição
audioFile	fileupload necessário	Sim	—
filterType	select	Não	Tipo filtragem espectral aplicar. Cada tipo tem características modelação frequência diferentes.
lowFreq	number	Não	Frequência centro ajustamentos banda baixa frequência.
lowGain	range	Não	Ajuste ganho banda baixa frequência. Positivo = aumentar, Negativo = cortar.
midFreq	number	Não	Frequência centro ajustamentos banda média frequência.
midGain	range	Não	Ajuste ganho banda média frequência. Positivo = aumentar, Negativo = cortar.
highFreq	number	Não	Frequência centro ajustamentos banda alta frequência.
highGain	range	Não	Ajuste ganho banda alta frequência. Positivo = aumentar, Negativo = cortar.
sharpness	range	Não	Quão íngremes transições filtro. Valores altos = focalização frequência mais precisa.
resonance	range	Não	Adiciona carácter retroalimentação filtro. Valores altos = resposta filtro mais pronunciada.
mix	range	Não	Balance entre sinal seco (original) e úmido (filtrado).
outputFormat	select	Não	—

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/audio-spectral-filter; o filePath retornado é então passado ao campo correspondente.

Formato de resposta

Resultado de arquivo

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

Integração MCP

Adicione esta ferramenta ao seu servidor Model Context Protocol para que agentes de IA possam listá-la e chamá-la.

Configuração do servidor

Adicione este bloco à configuração do seu cliente MCP:

mcp.json

{
  "mcpServers": {
    "elysiatools-audio-spectral-filter": {
      "name": "audio-spectral-filter",
      "description": "Filtra áudio baseado conteúdo espectral",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=audio-spectral-filter",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Listar ferramentas disponíveis

Após conectar ao endpoint SSE, liste as ferramentas expostas:

tools/list

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

Chamar esta ferramenta

Invoque a ferramenta pelo seu id; os argumentos são construídos a partir de seus parâmetros:

tools/call

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "audio-spectral-filter",
    "arguments": {
  "audioFile": "https://example.com/file.ext",
  "filterType": "enhance",
  "lowFreq": 100,
  "lowGain": 0,
  "midFreq": 1000,
  "midGain": 3,
  "highFreq": 5000,
  "highGain": 2,
  "sharpness": 0.5,
  "resonance": 0.3,
  "mix": 0.85,
  "outputFormat": "mp3"
}
  }
}

Encadeie várias ferramentas em uma sessão com uma lista toolId separada por vírgulas, p. ex. /mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp (máx. 20).

Parâmetros de arquivo aceitam somente uma URL de arquivo pública (https://…). Caminhos locais, data: URI e strings Base64 não são suportados.

Dúvidas ou problemas? Contate [email protected]