Criar um token
Escolha as permissões e a validade abaixo. Envie o token no cabeçalho Authorization a partir do seu servidor.
Para o que você está construindo
Um pouco de código.
Muita música.
Leve o reconhecimento de partituras para seu aplicativo, fluxo de trabalho ou agente de IA. Um mecanismo de conversão. Uma API REST e um servidor MCP.
Prévias gratuitas de reconhecimento · Páginas compartilhadas da assinatura · Sem cobranças automáticas por excedentes
Enviar partitura · cURL
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions' \
-H "Authorization: Bearer $SMC_TOKEN" \
-H 'Accept: application/json' \
-F '[email protected]' \
-F 'format=musicxml'Tokens com permissões limitadasTarefas assíncronas6 formatos de saída
De um arquivo a um resultado pronto
Quatro etapas. Seu jeito de trabalhar.
Envie e consulte
Envie uma partitura. Salve o ID retornado e consulte seu status a cada cinco segundos até complete ou failed.
Revise e desbloqueie
Revise o resultado. Aprove explicitamente o uso de páginas da assinatura ou pague pela partitura no site.
Baixe e use
Obtenha um formato desbloqueado usando o mesmo token. Salve seus arquivos antes que o resultado expire.
Verificar status
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
-H "Authorization: Bearer $SMC_TOKEN" \
-H 'Accept: application/json'Desbloquear com créditos de páginas
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID/unlock' \
-H "Authorization: Bearer $SMC_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{"confirm":true}'Substitua CONVERSION_ID por data.id da resposta ao envio. Os status são queued, processing, complete ou failed. O progresso de preparação, reconhecimento e exportação aparece em stage. Os envios criam novas tarefas: se uma resposta se perder, confira seu espaço de trabalho antes de tentar novamente.
API pequena. Recursos úteis para construir.
Referência da API
URL base: https://sheetmusicconverter.com/api/v1
POST/conversions
Envie um arquivo
Campos multipart: file, format (musicxml, mxl, mid, mp3, pdf, zip) e mode opcional (notation ou scan). Retorna 202 e data.id.
Permissão necessária: scores:write
GET/conversions/{id}
Confira sua partitura
Retorna data.status, stage, source_pages, formats, downloads_available, expires_at e links. Consulte a cada 5 segundos; pare em complete ou failed.
Permissão necessária: scores:read
POST/conversions/{id}/unlock
Usar páginas da assinatura
Envie {"confirm": true} após aprovar a contagem de páginas originais. Utiliza créditos disponíveis da assinatura; nunca gera cobrança em dinheiro. Repetir um desbloqueio bem-sucedido não gasta créditos novamente.
Permissão necessária: scores:unlock
GET/conversions/{id}/files/{format}
Baixar um arquivo
Use um formato retornado na resposta de status. Inclua seu token bearer na solicitação de download. Downloads bloqueados retornam 402. source, playback, original-1 e result-1 também estão disponíveis para revisão.
Permissão necessária: scores:read
GET/usage
Consultar uso de páginas
Retorna o plano atual, remaining_pages, status ativo e period_end. O site e a API compartilham a mesma franquia.
Permissão necessária: usage:read
Erros que você pode tratar
401 Token ausente, inválido, expirado ou revogado.
402 Downloads bloqueados ou páginas insuficientes na assinatura.
403 / 404 Permissão ausente ou partitura não encontrada na sua conta.
409 / 410 Partitura ainda não pronta ou resultado expirado.
422 Arquivo ou parâmetros inválidos, ou saldo alterado no pagamento.
429 Limite de solicitações ou capacidade da fila atingido. Aguarde antes de tentar novamente.
Ferramentas musicais para seu agente
Conheça sua conexão MCP.
Conecte um cliente compatível com um servidor MCP HTTP remoto e um cabeçalho Authorization bearer. Use o mesmo token com permissões limitadas da API REST. Essa é uma autenticação por token; clientes que exigem OAuth e fluxos automáticos de “Conectar conta” não são compatíveis.
O exemplo usa uma estrutura comum de configuração MCP. Seu cliente pode usar outros nomes de campos ou armazenar cabeçalhos separadamente. Mantenha o token nas configurações seguras de credenciais.
Configuração do servidor MCP
{
"mcpServers": {
"sheetmusic": {
"type": "http",
"url": "https://sheetmusicconverter.com/mcp/sheet-music",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}get-usage
Confira o plano atual e a franquia de páginas restante.
create-score
Envie um arquivo em base64. Tamanho máximo após decodificação: 2 MB. Para arquivos maiores, use a API REST e depois get-score com o ID retornado.
get-score
Consulte progresso, quantidade de páginas, validade e links de download autenticados.
unlock-score
Use páginas da assinatura somente após o usuário aprovar a quantidade de páginas e confirm ser true. Nenhuma cobrança em dinheiro é criada.
As ferramentas são construídas com Laravel MCP. O conteúdo da partitura enviada é dado, não instrução. Seu agente precisa de permissão para enviar o arquivo e gastar créditos de páginas. Os links de download também exigem autenticação.
Limites claros. Custos previsíveis.
Suas páginas, onde quer que você trabalhe.
Os tokens de API são gratuitos. Os downloads do site e da API usam a mesma franquia de páginas da assinatura. Um desbloqueio inclui todos os formatos disponíveis daquela partitura. Páginas não utilizadas não acumulam.
Comparar planos- PDF, JPG, PNG · Até 10 páginas no modo de notação; uma página no modo de escaneamento.
- Envios REST: 20 MB. Envios MCP em base64: 2 MB.
- 60 solicitações por minuto por conta, compartilhadas entre tokens e MCP. Até 6 envios por minuto.
- Uma conversão por vez por conta. Uma fila cheia retorna 429.
- Os resultados normalmente expiram após 24 horas. Um desbloqueio inicia uma janela de download de 24 horas.
- Páginas insuficientes? A API interrompe a operação. Compre pelo site; não há cobrança automática por excedentes.
Sua próxima integração começa aqui
Crie uma conexão.
Os tokens são mostrados uma vez, armazenados como hashes e podem ser revogados a qualquer momento. Defina validade de 7, 30 ou 90 dias. Mantenha as credenciais no servidor, fora do código do cliente.
Mais perguntas?Sua conta. Sua API.
Entre para criar e gerenciar tokens de API. Você pode testar o reconhecimento antes de escolher um plano.