Histórico de alterações

O painel de desenvolvedor foi reformulado com base no que sua integração pode fazer. Cada recurso (Embed, OMR, REST API, Import API, LTI) tem um cartão com seu escopo, preços e documentação, e os que seu app já usa aparecem primeiro.

• Uma nova seção de OMR no nível da conta, com suas tarefas, seus créditos e o histórico deles em um só lugar, já que os créditos de OMR são compartilhados por todos os seus apps.
• Experimente OMR antes de escrever código. O playground aceita um PDF ou fotos, mostra a quantidade de páginas, o custo por página e o saldo que restaria, e então executa a tarefa depois da sua confirmação. A saída vai para downloads em MusicXML, nada é enviado para a sua biblioteca.
• Páginas de app mais claras. Tokens pessoais, credenciais OAuth2 e acesso ao OMR ficam agrupados por aplicação, com destaque para as credenciais que incluem o escopo de OMR.

Abra em flat.io/developers.

Nossa especificação da REST API passa para OpenAPI 3.1, a API OMR encerra seu período beta, e as tarefas do Flat for Education passam a ir além de listagem e criação.

• A API OMR está estável. Endpoints, campos e comportamento agora seguem nosso processo usual de descontinuação antes de qualquer mudança incompatível. Um novo FAQ cobre créditos e cobrança, limites e tempos de processamento, qualidade de reconhecimento e idiomas, além de uso comercial e privacidade.
• Leia, atualize e exclua tarefas no Flat for Education. Excluir uma tarefa também remove seus envios e as cópias dos alunos; em vez disso, arquive-a para manter o trabalho.
• Extrato de créditos. Uma nova chamada lista seu histórico de créditos; o saldo continua na chamada de recursos do OMR.
• Arquivos Finale (.musx) podem ser importados, em regime de melhor esforço, e a importação de música digitalizada (PDF e imagens) está documentada na criação de partituras.
• OpenAPI 3.1. Campos nullable usam a sintaxe 3.1; ferramentas fixadas em OpenAPI 3.0 precisam de atualização. O campo mimeType foi removido dos uploads de arquivos OMR.

O Flat agora tem um app para desktop para macOS e Windows: o editor completo em uma janela própria, grátis para baixar, com sua biblioteca sincronizada entre desktop, web e celular.

• Funciona offline. Escreva, edite e reproduza partituras sem conexão; suas alterações são sincronizadas quando você voltar a ficar online.
• Suas partituras em todos os dispositivos. Com Flat Power, a biblioteca que você vê no desktop é a mesma que você abre na web, no iPhone, iPad e Android.
• Entrada MIDI via USB e Bluetooth. Conecte um teclado e toque as notas para inseri-las.
• Abre seus arquivos. Dê um clique duplo em uma partitura no Finder ou no Explorer e ela será aberta no app, não em uma aba do navegador.
• Iniciar sessão com a Apple no macOS, além das opções de login que você já tinha.
• Mantém-se atualizado. As novas versões são instaladas automaticamente.

Grátis para baixar; uma conta Flat só é necessária para sincronizar. Baixe em flat.io/desktop.

Selecione um trecho, pressione L e ele se repete até você mandar parar, enquanto as notas continuam editáveis, para que cada alteração apareça na próxima volta. O modo de loop é gratuito em todos os planos.

• Três maneiras de iniciar um loop: selecione compassos e pressione L, escolha Loop no menu de seleção ou pressione o botão de loop no cabeçalho para repetir o compasso em que o cursor está. Arraste as alças para ampliar ou reduzir o intervalo, até mesmo durante a reprodução.
• As notas continuam editáveis. Clique em uma nota enquanto ela toca, altere-a e ouça o resultado na próxima volta. Os loops também funcionam com YouTube, Vimeo, SoundCloud sincronizados ou com uma gravação enviada.
• A reprodução começa no cursor, não no início. Ao parar, a posição é mantida: Espaço reproduz a partir do cursor, Shift + Espaço retoma exatamente de onde a música parou (pressione e segure Reproduzir no celular). Voltar ao início move o cursor quando a reprodução está parada e reinicia a reprodução quando está tocando.

Disponível no novo editor na web e na nova barra de ferramentas móvel no Android; o iOS vem em seguida. Partituras incorporadas também podem usar loop pela embed API.

Uma nova versão do nosso modelo interno agora está por trás de toda importação de PDF e foto, com foco em como as tercinas e outras quiálteras são impressas na página.

• Quiálteras implícitas agora são suportadas. Os gravadores musicais costumam imprimir o pequeno "3" ou "6" apenas sobre a primeira tercina ou sextina de uma passagem, e deixam os grupos seguintes sem marcação — espera-se que o músico continue o padrão. Esses grupos não marcados são quiálteras implícitas: são tocados como quiálteras, sem nada impresso para indicar isso. Elas são muito comuns em edições do século XIX, estudos e variações. O escaneamento agora as reconstrói a partir do ritmo do compasso, em vez de eliminar notas para fazer o compasso caber em sua fórmula de compasso.
• Menos quiálteras inventadas do nada. O modelo costumava marcar grupos normais com hastes unidas por barra como tercinas mesmo quando nenhum número era impresso sobre eles, e esses números apareciam na sua partitura. Agora ele só escreve uma quiáltera onde ela realmente está desenhada na página.

• Retenção de dados sob seu controle. Os trabalhos OMR agora informam por quanto tempo seus arquivos são mantidos (30 dias por padrão), cada trabalho MusicXML inclui sua data de expiração, e você pode apagar os arquivos e resultados de um trabalho assim que coletá-los.
• Detecção de recursos antes do login. A chamada de capacidades do OMR funciona sem uma conta e lista os idiomas de reconhecimento compatíveis com seus nomes.
• Exportação de notação ABC para qualquer revisão da partitura, junto com MusicXML, MIDI e os outros formatos. Assim como o MIDI, ela não inclui toda a gravação tipográfica.
• Tarefas Free Record podem ser configuradas pela API no Flat for Education.
• Erros vindos de um provedor upstream (como o Google Classroom, por exemplo) agora incluem a própria mensagem localizada do provedor.

Uma nova versão do nosso modelo interno agora é usada em todas as importações de PDFs e fotos, com 22% a 51% menos erros em nossos testes de referência com partituras digitalizadas. Os ganhos são maiores nas páginas mais difíceis — impressões antigas e qualidade de impressão irregular.

Uma versão aprimorada do modelo interno do Flat agora é usada em todas as importações de PDF e fotos, em especial:

• Trechos com várias vozes, com pausas compartilhadas e pausas invisíveis, agora são compatíveis.
• Barras de compasso e finais de repetição (voltas) agora são posicionados corretamente dentro dos compassos.
• As ligaduras de colcheias são reconhecidas com mais confiabilidade.
• Fórmulas de compasso escritas em várias pautas, como em partituras orquestrais, agora são reconhecidas.
• Corrigidos alguns símbolos de acordes que eram exportados para MusicXML com um tipo de acorde fora do padrão.

A importação de partituras a partir de um PDF ou de uma foto ganhou um novo fluxo no aplicativo web, desenvolvido com o mecanismo de reconhecimento próprio da Flat. Ele substitui a importação anterior de PDF para todos.

• Escolha as páginas que você quer. Envie um PDF ou várias fotos e mantenha apenas as páginas que contêm a música. Cada página mantida usa um crédito.
• Acompanhe o reconhecimento enquanto ele acontece. Uma barra de progresso mostra em que etapa está a digitalização, página por página, e você pode continuar usando o Flat enquanto o processo é executado.
• Revise antes de a partitura ser criada. Quando o mecanismo não tem certeza sobre um instrumento, ele pede que você confirme o título e os instrumentos detectados, com os nomes das partes impressos na página exibidos ao lado de cada um. Quando todos os instrumentos são identificados com certeza, essa etapa é ignorada.

Disponível no Flat e, para professores e administradores, no Flat for Education. O novo fluxo chegará ao app para iOS nas próximas semanas.

O mecanismo de OMR do Flat agora está disponível programaticamente por meio da API para desenvolvedores. Envie PDFs ou fotos, acompanhe o progresso do reconhecimento, revise os instrumentos detectados e depois importe o resultado como uma partitura editável em uma biblioteca do Flat ou exporte em MusicXML ou MIDI. É o mesmo modelo interno que viabiliza a importação de PDFs e fotos no editor, agora disponível em escala para seus próprios apps e fluxos de trabalho.

A API dedicada de OMR (v2.24.0) se baseia na importação de PDFs em segundo plano adicionada à criação de partituras na v2.23.0: solicite suporte a tarefas ao importar um arquivo e faça polling da tarefa até que a partitura esteja pronta. Consulte o changelog da API para ver os detalhes de ambas as versões.

Melhoramos a forma como a digitalização lê o layout de uma página. As importações de PDFs e fotos agora geram partituras mais limpas e precisas, especialmente em layouts complexos:

• Páginas densas agora são divididas corretamente. Páginas com muitos sistemas curtos empilhados uns sobre os outros não são mais mescladas — cada sistema é detectado separadamente.
• Melhor em partituras orquestrais e de grandes conjuntos. Instrumentos com múltiplos pentagramas, como piano e órgão, e partituras grandes com muitos pentagramas são reconhecidos com mais confiabilidade.
• Layouts amplos, em paisagem e em livreto. Páginas em formato paisagem não cortam mais a borda esquerda (o que podia cortar claves), e digitalizações de várias páginas e em livreto são tratadas corretamente.
• Menos detecções indevidas. Elementos espúrios perto dos rodapés e das margens da página não são mais identificados como música.

Toda importação de PDF e foto agora é processada pelo modelo próprio da Flat. Esta versão é uma grande atualização focada na precisão da transcrição: a correção musical (as notas, ritmos, ligaduras e acidentes que determinam se uma partitura está correta) melhora em todos os conjuntos de teste, com os maiores ganhos em:

• Dinâmicas: +39%
• Fermatas, articulações, ligaduras, acidentes: +30 a 37%
• Duração das notas: +22%
• Ligaduras de frase, notas pontuadas, pausas, atribuição de pauta e voz: +14 a 20%

O posicionamento de texto, dinâmicas e layout também está mais preciso: letras, cifras e dinâmicas são associadas com mais confiabilidade às notas corretas, inclusive em layouts complexos, como pautas duplas de piano e partes com mudanças de clave.

Estamos disponibilizando o modelo de IA da própria Flat para importação de PDFs e fotos, desenvolvido e treinado internamente para substituir o mecanismo de terceiros usado no lançamento. Ter essa tecnologia de ponta a ponta nos permite avançar ainda mais na precisão, ampliar o que reconhecemos, lançar melhorias muito mais rápido e alinhar os resultados ao próprio formato de notação da Flat, para que as importações se encaixem naturalmente no restante do produto. Esta primeira versão já consegue ler muito mais da sua música:

Cobertura de notação mais ampla. Itens recém-reconhecidos:

• Cifras de acordes, codificadas corretamente com seu significado musical como acordes editáveis, e não apenas como texto simples
• Repetições de compasso e barras rítmicas
• Marcações de andamento e metrônomo (com BPM)

Letras e texto em mais idiomas. Letras, marcas de ensaio e outros textos são reconhecidos por padrão em idiomas com escrita latina, além de japonês, coreano e chinês.

Mais fiel ao layout original. As importações agora seguem muito mais de perto o layout da partitura de origem, correspondendo ao número de compassos por linha, sistemas por página e à estrutura geral. Isso faz uma diferença real em partituras grandes e complexas, como obras orquestrais e instrumentos com múltiplos pentagramas, como piano. Também há suporte a mais formatos de página, incluindo páginas na orientação paisagem que antes não eram compatíveis.

A maior atualização da especificação desde 2024, colocando a API em dia com dois anos de mudanças no produto.

• Importação de mais de 15 formatos. Guitar Pro, MuseScore, notação ABC, PowerTab, Capella, MEI, Overture, TablEdit, Band-in-a-Box, Karaoke MIDI, MuseData, Score Writer, Bagpipe Music Writer e Encore se juntam a MusicXML e MIDI, e as partituras podem ser exportadas como arquivos .flat nativos.
• Coleções virtuais. Todas as partituras, colaborações e curtidas substituem a antiga hierarquia de pastas na biblioteca, acompanhando a biblioteca Flat redesenhada.
• Flat for Education. Atividades de performance com gravações de áudio ou vídeo e opções de backing track, metrônomo e velocidade; entregas em grupo para escrita compartilhada; instruções com rich text; subgrupos de alunos; tarefas do Microsoft Teams agendadas e direcionadas individualmente; descrições ricas e tipos de atividade na biblioteca de recursos.
• Configuração LTI unificada para LTI 1.1 e 1.3, incluindo registro dinâmico. As chamadas anteriores de credenciais do LTI 1.1 foram descontinuadas.
• Estatísticas anuais sobre partituras, contagens de partituras públicas nos perfis e remoção de alguns campos descontinuados há muito tempo.