Per ciò che stai costruendo

Un po’ di codice.
Tanta musica.

Porta il riconoscimento degli spartiti nella tua app, nel tuo flusso di lavoro o nel tuo agente IA. Un motore di conversione. Un’API REST e un server MCP.

Ottieni il tuo token APICollega un agente

Anteprime di riconoscimento gratuite · Pagine dell’abbonamento condivise · Nessun extra automatico

Carica uno spartito · 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'
Token con autorizzazioni limitateProcessi asincroni6 formati di output

Da un file a un risultato pronto

Quattro passaggi. Il tuo modo di lavorare.

01

Crea un token

Scegli autorizzazioni e scadenza qui sotto. Invia il token nell’header Authorization dal tuo server.

02

Carica e interroga

Carica uno spartito. Salva l’ID restituito, poi controlla lo stato ogni cinque secondi fino a complete o failed.

03

Controlla e sblocca

Controlla il risultato. Approva esplicitamente l’uso delle pagine dell’abbonamento oppure paga lo spartito sul sito.

04

Scarica e usa

Recupera un formato sbloccato con lo stesso token. Salva i file prima che il risultato scada.

Controlla lo stato
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
Sblocca con crediti di pagine
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}'

Sostituisci CONVERSION_ID con data.id della risposta al caricamento. Gli stati sono queued, processing, complete o failed. L’avanzamento di preparazione, riconoscimento ed esportazione compare in stage. I caricamenti creano nuovi processi: se una risposta si perde, controlla lo spazio di lavoro prima di riprovare.

Un’API essenziale. Strumenti utili per costruire.

Riferimento API

URL di base: https://sheetmusicconverter.com/api/v1

POST/conversions

Carica un file

Campi multipart: file, format (musicxml, mxl, mid, mp3, pdf, zip) e mode facoltativo (notation o scan). Restituisce 202 e data.id.

Autorizzazione richiesta: scores:write

GET/conversions/{id}

Controlla lo spartito

Restituisce data.status, stage, source_pages, formats, downloads_available, expires_at e links. Interroga ogni 5 secondi; fermati a complete o failed.

Autorizzazione richiesta: scores:read

POST/conversions/{id}/unlock

Usa pagine dell’abbonamento

Invia {"confirm": true} dopo aver approvato il numero di pagine originali. Consuma crediti disponibili dell’abbonamento; non crea mai un addebito monetario. Ripetere uno sblocco riuscito non consuma nuovamente crediti.

Autorizzazione richiesta: scores:unlock

GET/conversions/{id}/files/{format}

Scarica un file

Usa un formato restituito nella risposta di stato. Includi il token bearer nella richiesta di download. I download bloccati restituiscono 402. Anche source, playback, original-1 e result-1 sono disponibili per la revisione.

Autorizzazione richiesta: scores:read

GET/usage

Leggi utilizzo delle pagine

Restituisce il piano attuale, remaining_pages, stato attivo e period_end. Il sito e l’API condividono la stessa quota.

Autorizzazione richiesta: usage:read

Errori che puoi gestire

401 Token mancante, non valido, scaduto o revocato.

402 Download bloccati o pagine dell’abbonamento insufficienti.

403 / 404 Autorizzazione mancante o spartito non trovato nel tuo account.

409 / 410 Spartito non pronto o risultato scaduto.

422 File o parametri non validi, oppure saldo del pagamento modificato.

429 Limite di richieste o capacità della coda raggiunti. Attendi prima di riprovare.

Strumenti musicali per il tuo agente

Scopri la tua connessione MCP.

Collega un client che supporti un server MCP HTTP remoto con un header Authorization bearer. Usa lo stesso token con autorizzazioni limitate dell’API REST. Si tratta di autenticazione tramite token; i client che richiedono OAuth e i flussi automatici “Collega account” non sono supportati.

L’esempio usa una struttura di configurazione MCP comune. Il client potrebbe usare nomi di campo diversi o archiviare separatamente gli header. Conserva il token nelle impostazioni sicure delle credenziali.

Configurazione del server MCP
{
  "mcpServers": {
    "sheetmusic": {
      "type": "http",
      "url": "https://sheetmusicconverter.com/mcp/sheet-music",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

get-usage

Controlla il piano attuale e la quota di pagine residua.

create-score

Invia un file in base64. Dimensione massima decodificata: 2 MB. Per file più grandi usa l’API REST, poi get-score con l’ID restituito.

get-score

Leggi avanzamento, numero di pagine, scadenza e link di download autenticati.

unlock-score

Usa le pagine dell’abbonamento solo dopo l’approvazione del numero di pagine da parte dell’utente e con confirm impostato a true. Non vengono creati addebiti monetari.

Gli strumenti sono realizzati con Laravel MCP. Il contenuto dello spartito caricato è un dato, non un’istruzione. L’agente deve avere il permesso di caricare il file e usare crediti di pagine. Anche i link di download richiedono autenticazione.

Limiti chiari. Costi prevedibili.

Le tue pagine, ovunque lavori.

I token API sono gratuiti. I download dal sito e dall’API usano la stessa quota di pagine dell’abbonamento. Uno sblocco include tutti i formati disponibili per quello spartito. Le pagine non utilizzate non si accumulano.

Confronta i piani
  • PDF, JPG, PNG · Fino a 10 pagine in modalità notazione; una pagina in modalità scansione.
  • Caricamenti REST: 20 MB. Caricamenti MCP in base64: 2 MB.
  • 60 richieste al minuto per account, condivise tra token e MCP. Fino a 6 caricamenti al minuto.
  • Una conversione alla volta per account. Una coda piena restituisce 429.
  • I risultati scadono normalmente dopo 24 ore. Uno sblocco avvia una finestra di download di 24 ore.
  • Pagine insufficienti? L’API si ferma. Acquista sul sito; nessun addebito automatico per gli extra.

La tua prossima integrazione comincia qui

Crea una connessione.

I token vengono mostrati una volta, conservati come hash e possono essere revocati in qualsiasi momento. Imposta una scadenza di 7, 30 o 90 giorni. Mantieni le credenziali sul server, fuori dal codice client.

Altre domande?

Il tuo account. La tua API.

Accedi per creare e gestire token API. Puoi provare il riconoscimento prima di scegliere un piano.

AccediCrea un account