Categorias

Detector de Tonalidade

Detecta a tonalidade de uma faixa

Analisa energia por classe de altura e compara com perfis maior/menor.

Click to upload file or drag and drop file here

Maximum file size: 200MB Supported formats: audio/*

Fatos principais

Categoria
Media
Tipos de entrada
file, text
Tipo de saída
json
Cobertura de amostras
4
API disponível
Yes

Visão geral

O Detector de Tonalidade é uma ferramenta precisa que identifica automaticamente a tonalidade musical de arquivos de áudio, analisando a energia das classes de altura e comparando-as com perfis de escalas maiores e menores.

Quando usar

  • Ao organizar sua biblioteca musical por escalas harmônicas.
  • Ao preparar sets de DJ para garantir transições suaves entre faixas.
  • Ao transcrever músicas e precisar identificar a tonalidade original rapidamente.

Como funciona

  • Envie o seu arquivo de áudio no formato suportado.
  • Defina o tempo de análise em segundos, se desejar um trecho específico.
  • O sistema processa a energia das notas presentes no áudio.
  • A ferramenta compara os dados com perfis musicais e retorna a tonalidade detectada.

Casos de uso

Harmonização de sets de DJ para mixagem harmônica.
Auxílio na composição e arranjo musical.
Catalogação automática de grandes coleções de arquivos de áudio.

Exemplos

1. Preparação de Set de DJ

DJ Profissional
Contexto
Um DJ precisa organizar uma playlist de 50 faixas para garantir que a transição entre elas seja musicalmente compatível.
Problema
Identificar a tonalidade de cada faixa manualmente é demorado e propenso a erros auditivos.
Como usar
Carregue a faixa de áudio e utilize a configuração padrão de 90 segundos para obter a tonalidade principal.
Resultado
O sistema retorna a tonalidade (ex: Dó Maior), permitindo que o DJ agrupe faixas compatíveis no software de mixagem.

2. Transcrição Musical

Músico
Contexto
Um músico está tentando tirar uma música de ouvido, mas tem dificuldade em identificar o tom base da gravação.
Problema
Dificuldade em encontrar a nota fundamental para começar a transcrição.
Como usar
Envie o arquivo da música e execute a análise para confirmar a tonalidade.
Resultado
A ferramenta identifica a tonalidade, facilitando a escolha da escala correta para a transcrição.

Testar com amostras

audio, file

Hubs relacionados

FAQ

Quais formatos de áudio são suportados?

A ferramenta aceita a maioria dos formatos de áudio padrão, como MP3, WAV e outros arquivos de áudio comuns.

Como funciona a análise de tonalidade?

O algoritmo calcula a energia de cada classe de altura (pitch class) e a compara com modelos estatísticos de escalas maiores e menores.

Posso analisar apenas uma parte da música?

Sim, você pode configurar o campo 'Segundos de análise' para focar em um trecho específico da faixa.

A detecção é 100% precisa?

A precisão é muito alta para músicas com estrutura harmônica clara, embora ruídos excessivos possam afetar o resultado.

Existe limite de tamanho para o arquivo?

Sim, o limite máximo para upload é de 200 MB por arquivo.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/audio-key-detector

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
audioFile file (Upload necessário) Sim -
analysisSeconds text Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/audio-key-detector para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.

Formato de resposta

{
  "key": {...},
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Dados JSON: Dados JSON

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-audio-key-detector": {
      "name": "audio-key-detector",
      "description": "Detecta a tonalidade de uma faixa",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=audio-key-detector",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]