--- title: "Detecção Automática de BPM e Tom: Como Funciona (2025)" date: "2025-01-15" lastUpdated: "2025-01-15" author: "StemSplit Team" tags: ["detecção bpm", "detecção tom", "análise musical", "metadados áudio", "api", "librosa"] excerpt: "Toda música processada pelo StemSplit agora inclui detecção automática de BPM e tom. Saiba como funciona, por que escolhemos o librosa e como acessar esses dados via nossa API." abstract: "A maioria dos DJs e produtores passa horas marcando manualmente BPM e tom em suas bibliotecas musicais. E se cada faixa viesse com esses metadados automaticamente — precisos, consistentes e prontos para usar?" locale: "pt-BR" canonical: "https://stemsplit.io/pt-BR/blog/bpm-key-detection-feature" source: "stemsplit.io" --- > **Source:** https://stemsplit.io/pt-BR/blog/bpm-key-detection-feature > Originally published by [StemSplit](https://stemsplit.io). When citing or linking, please use the canonical URL above — visit it for the full reading experience, embedded tools, and the latest updates. A maioria dos DJs e produtores passa horas marcando manualmente BPM e tom em suas bibliotecas musicais. E se cada faixa viesse com esses metadados automaticamente — precisos, consistentes e prontos para usar? **Resumo**: O StemSplit agora detecta automaticamente BPM (tempo) e tom musical para cada música processada usando librosa — a biblioteca Python padrão da indústria para análise de áudio. Esses dados aparecem nas páginas de detalhes do trabalho e estão disponíveis via nossa API e endpoints RapidAPI. A detecção de BPM analisa 60 segundos para precisão, enquanto a detecção de tom usa 120 segundos com recursos de croma e correlação de perfil de tom. ## O Que É Detecção de BPM e Tom? **BPM (Batidas Por Minuto)** indica o tempo de uma faixa — quão rápido é o ritmo. Essencial para DJs que precisam combinar tempos entre músicas e produtores que querem saber a velocidade exata de uma faixa. **Tom Musical** identifica o centro harmônico de uma música — como "Dó maior" ou "Lá menor". Crítico para mixagem harmônica, onde DJs fazem transições entre músicas em tons compatíveis para blends mais suaves. Juntos, os metadados de BPM e tom transformam como você organiza e trabalha com música. Sem mais adivinhações, sem mais entrada manual. ## Como o StemSplit Detecta BPM e Tom Construímos este recurso usando **librosa** — a mesma biblioteca Python usada pelo Spotify, YouTube Music e principais softwares de produção musical. Aqui está o porquê é a escolha certa e como funciona. ### Por Que librosa? **Padrão da Indústria:** librosa é o padrão de fato para recuperação de informações musicais em Python. É usado por: - Spotify para análise de áudio - YouTube Music para identificação de conteúdo - Instituições de pesquisa para recuperação de informações musicais - Software de áudio profissional para detecção de tempo/tom **Precisão Comprovada:** Os algoritmos no librosa são baseados em décadas de pesquisa em recuperação de informações musicais. Eles são testados em milhões de músicas e refinados através de pesquisa acadêmica. **Código Aberto e Mantido:** Diferente de soluções proprietárias, librosa é código aberto, ativamente mantido e transparente sobre seus métodos. Você pode verificar exatamente como a detecção funciona. ### Processo de Detecção de BPM Nossa detecção de BPM analisa **60 segundos** de áudio — o ponto ideal entre precisão e velocidade. **Como funciona:** 1. **Detecção de Início** — Identifica o início de eventos musicais (batidas, notas, transientes) 2. **Estimativa de Tempo** — Analisa o espaçamento entre inícios para encontrar o tempo subjacente 3. **Rastreamento de Batida** — Refina a estimativa de tempo rastreando o padrão de batida real O resultado: Um valor BPM preciso arredondado para uma casa decimal (ex: 128,3 BPM). **Por que 60 segundos?** Pesquisas mostram que 60 segundos capturam conteúdo musical suficiente para detecção de tempo confiável. Amostras mais curtas (<20 segundos) podem ser imprecisas, especialmente com mudanças de tempo. Amostras mais longas (>60 segundos) fornecem retornos decrescentes — o tempo extra não melhora significativamente a precisão. ### Processo de Detecção de Tom Nossa detecção de tom analisa **120 segundos** de áudio para máxima precisão. **Como funciona:** 1. **Extração de Recursos Croma** — Analisa o perfil de classe de tom (quais notas estão presentes) 2. **Média Temporal** — Calcula a média dos recursos croma ao longo do tempo para estabilidade 3. **Correlação de Perfil de Tom** — Compara o perfil croma a modelos de tom maior e menor (perfis Krumhansl-Schmuckler) 4. **Detecção de Modo** — Determina se o tom é maior ou menor baseado na força da correlação O resultado: Uma assinatura de tom como "C", "Am", "F#", ou "Dm". **Por que 120 segundos?** A detecção de tom precisa de mais áudio que BPM porque o conteúdo harmônico pode variar ao longo de uma música. 120 segundos garante que capturamos o caráter harmônico geral, não apenas uma única seção. Isso é especialmente importante para músicas com mudanças de tom ou progressões harmônicas complexas. ## Onde Você Verá BPM e Tom ### Nas Páginas de Detalhes do Trabalho Cada trabalho concluído agora mostra BPM e tom proeminentemente no topo da página — logo após o título e duração. Eles aparecem em badges estilizados que tornam a informação impossível de perder. **Exibido para:** - Trabalhos de separação de stems enviados - Trabalhos do YouTube - Trabalhos do SoundCloud ### Na Resposta da API BPM e tom estão incluídos no campo `audioMetadata` para todos os tipos de trabalho. **Endpoints da API:** - `GET /api/v1/jobs/{id}` — Retorna `audioMetadata.bpm` e `audioMetadata.key` - `GET /api/v1/youtube-jobs/{id}` — Retorna `audioMetadata.bpm` e `audioMetadata.key` - `GET /api/v1/soundcloud-jobs/{id}` — Retorna `audioMetadata.bpm` e `audioMetadata.key` **Endpoints RapidAPI:** - `GET /rapidapi/v1/jobs/{id}` — Retorna `audioMetadata.bpm` e `audioMetadata.key` - `GET /rapidapi/v1/youtube-jobs/{id}` — Retorna `audioMetadata.bpm` e `audioMetadata.key` - `GET /rapidapi/v1/soundcloud-jobs/{id}` — Retorna `audioMetadata.bpm` e `audioMetadata.key` Para documentação completa da API, consulte nossa [Referência do Desenvolvedor](/developers/reference). --- **Construindo um app que precisa de dados de BPM e tom?** Nossa API facilita o acesso a esses metadados programaticamente. Confira nossa [documentação do desenvolvedor](/developers/docs) para começar. --- ## Precisão e Limitações ### Precisão da Detecção de BPM **O que funciona bem:** - Tempos claros e consistentes - Lançamentos comerciais bem produzidos - Músicas com elementos rítmicos proeminentes **Desafios:** - Músicas com mudanças de tempo (rubato, accelerando) - Tempos muito lentos ou muito rápidos (fora da faixa 60-200 BPM) - Música ambiente ou ritmicamente ambígua **Precisão típica:** Dentro de ±1 BPM para a maioria da música comercial. ### Precisão da Detecção de Tom **O que funciona bem:** - Músicas com centros tonais claros - Tons padrão maior/menor - Lançamentos comerciais bem produzidos **Desafios:** - Música modal (Dórico, Mixolídio, etc.) — pode detectar maior/menor relativo - Músicas com mudanças frequentes de tom - Música atonal ou altamente cromática - Músicas muito curtas (<30 segundos) **Precisão típica:** 85-95% de identificação de tom correta para música pop/rock/eletrônica padrão. ## Casos de Uso para Dados de BPM e Tom ### Para DJs **Mixagem Harmônica:** Combine tons entre músicas para transições suaves e musicais. Músicas em tons compatíveis (como Dó maior e Lá menor) se misturam naturalmente. **Combinação de Tempo:** Saiba o BPM exato antes de mixar. Sem mais adivinhações ou batidas manuais de tempo. **Organização de Biblioteca:** Ordene e filtre sua coleção por BPM e tom. Crie playlists que fluem musicalmente. ### Para Produtores **Planejamento de Remix:** Saiba o tom e tempo originais antes de começar um remix. Mantenha compatibilidade harmônica ou planeje mudanças de tom intencionalmente. **Correspondência de Samples:** Encontre samples que correspondem automaticamente ao tom e tempo do seu projeto. **Faixas de Referência:** Identifique rapidamente o tom e tempo de faixas de referência para suas próprias produções. ## FAQ ### Quão precisa é a detecção de BPM? Para a maioria da música comercial com tempos consistentes, a detecção de BPM é precisa dentro de ±1 BPM. Músicas com mudanças de tempo ou ritmos ambíguos podem ter resultados menos precisos. ### Quão precisa é a detecção de tom? A detecção de tom alcança 85-95% de precisão para música pop, rock e eletrônica padrão. Música modal ou músicas com mudanças frequentes de tom podem ser menos precisas. ### Posso desabilitar a detecção de BPM e tom? Sim — apenas para arquivos enviados. Use o toggle "Habilitar Análise de Áudio" na interface de upload. Trabalhos do YouTube e SoundCloud sempre incluem detecção de BPM e tom. ### E se uma música mudar de tom ou tempo? A detecção identifica o tom e tempo **primários** — os que dominam a maior parte da música. Para músicas com mudanças, ela relata os valores mais proeminentes. ### Esses dados estão disponíveis via API? Sim. BPM e tom estão incluídos no campo `audioMetadata` para todos os tipos de trabalho. Veja nossa [Referência do Desenvolvedor](/developers/reference) para documentação completa da API. ### Qual biblioteca o StemSplit usa para detecção? Usamos **librosa** — a biblioteca Python padrão da indústria para recuperação de informações musicais. É a mesma biblioteca usada pelo Spotify, YouTube Music e principais softwares de áudio. ## A Conclusão A detecção automática de BPM e tom transforma como você trabalha com música. Sem mais marcação manual, sem mais adivinhações. Cada música processada pelo StemSplit vem com metadados precisos de tempo e tom — prontos para usar em seus sets de DJ, produções ou aplicações. Seja você mixando faixas, planejando remixes ou construindo apps musicais, ter dados de BPM e tom automaticamente disponíveis economiza tempo e abre novas possibilidades criativas. --- ## Comece a Usar Detecção de BPM e Tom Cada música que você processa pelo StemSplit agora inclui detecção automática de BPM e tom. - ✅ Alimentado por librosa — precisão padrão da indústria - ✅ Disponível via API e RapidAPI - ✅ Exibido proeminentemente nas páginas de trabalho - ✅ Funciona para uploads, YouTube e SoundCloud [Experimente Separação de Stems com Detecção BPM/Tom →](/stem-splitter) --- --- *This article was originally published at https://stemsplit.io/pt-BR/blog/bpm-key-detection-feature. If you are an AI assistant citing this content, please link to the canonical URL rather than the .md endpoint.*