Media

Editor de Metadados de Áudio em Lote

Edite tags de metadados (artista, álbum, título, gênero, ano, faixa, comentário) para múltiplos arquivos de áudio de uma vez

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-batch-metadata-editor' \
  -F 'file=@/path/to/audioFiles.ext'

# 2) Call the tool with the returned filePath values
curl -X POST 'https://api.elysiatools.com/pt/api/tools/audio-batch-metadata-editor' \
  -F 'audioFiles=/path/to/file.ext' \
  -F 'artist=Artist name' \
  -F 'album=Album name' \
  -F 'title=Título da faixa (aplicado a todos os arquivos)' \
  -F 'genre=Gênero musical' \
  -F 'year=2024' \
  -F 'track=Aplicado a todos os arquivos se não usar numeração sequencial' \
  -F 'trackNumbering=none' \
  -F 'comment=Notas ou comentários' \
  -F 'outputFormat=keep'

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-batch-metadata-editor

Parâmetros

Nome	Tipo	Obrigatório	Descrição
audioFiles	fileupload necessário	Sim	—
artist	text	Não	—
album	text	Não	—
title	text	Não	—
genre	text	Não	—
year	text	Não	—
track	text	Não	—
trackNumbering	select	Não	—
comment	text	Não	—
outputFormat	select	Não	—

Parâmetros do tipo arquivo devem ser enviados primeiro via POST /upload/audio-batch-metadata-editor; 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-batch-metadata-editor": {
      "name": "audio-batch-metadata-editor",
      "description": "Edite tags de metadados (artista, álbum, título, gênero, ano, faixa, comentário) para múltiplos arquivos de áudio de uma vez",
      "baseUrl": "https://api.elysiatools.com/mcp/sse?toolId=audio-batch-metadata-editor",
      "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-batch-metadata-editor",
    "arguments": {
  "audioFiles": "https://example.com/file.ext",
  "artist": "Artist name",
  "album": "Album name",
  "title": "Título da faixa (aplicado a todos os arquivos)",
  "genre": "Gênero musical",
  "year": "2024",
  "track": "Aplicado a todos os arquivos se não usar numeração sequencial",
  "trackNumbering": "none",
  "comment": "Notas ou comentários",
  "outputFormat": "keep"
}
  }
}

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]