Skapa en token
Välj behörigheter och giltighetstid nedan. Skicka token i Authorization-headern från din server.
För det du bygger
Lite kod.
Mycket musik.
Integrera notigenkänning i din app, ditt arbetsflöde eller din AI-agent. En konverteringsmotor. Ett REST-API och en MCP-server.
Kostnadsfria igenkänningsförhandsvisningar · Gemensam sidpott · Inga automatiska överförbrukningsavgifter
Ladda upp noter · 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'Behörighetsbegränsade tokenAsynkrona jobb6 utdataformat
Från fil till färdigt resultat
Fyra steg. Ditt arbetsflöde.
Ladda upp och kontrollera status
Ladda upp noter. Spara det returnerade ID:t och kontrollera status var femte sekund tills den är complete eller failed.
Granska och lås upp
Granska resultatet. Godkänn uttryckligen användning av abonnemangssidor eller betala för noterna på webbplatsen.
Ladda ner och använd
Hämta ett upplåst format med samma token. Spara filerna innan resultatet löper ut.
Kontrollera status
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
-H "Authorization: Bearer $SMC_TOKEN" \
-H 'Accept: application/json'Lås upp med sidkrediter
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}'Ersätt CONVERSION_ID med data.id från uppladdningssvaret. Statusvärden är queued, processing, complete eller failed. Förlopp för förberedelse, igenkänning och export visas i stage. Uppladdningar skapar nya jobb: om ett svar försvinner, kontrollera arbetsytan innan du försöker igen.
Litet API. Användbara byggstenar.
API-referens
Bas-URL: https://sheetmusicconverter.com/api/v1
POST/conversions
Ladda upp en fil
Multipart-fält: file, format (musicxml, mxl, mid, mp3, pdf, zip) och valfritt mode (notation eller scan). Returnerar 202 och data.id.
Behörighet som krävs: scores:write
GET/conversions/{id}
Kontrollera dina noter
Returnerar data.status, stage, source_pages, formats, downloads_available, expires_at och links. Kontrollera var femte sekund; sluta vid complete eller failed.
Behörighet som krävs: scores:read
POST/conversions/{id}/unlock
Använd abonnemangssidor
Skicka {"confirm": true} efter att ha godkänt antalet originalsidor. Använder tillgängliga abonnemangskrediter; skapar aldrig en penningdebitering. En upprepad lyckad upplåsning förbrukar inget ytterligare.
Behörighet som krävs: scores:unlock
GET/conversions/{id}/files/{format}
Ladda ner en fil
Använd ett format från statussvaret. Skicka din bearer-token i nedladdningsanropet. Låsta nedladdningar returnerar 402. source, playback, original-1 och result-1 finns också för granskning.
Behörighet som krävs: scores:read
GET/usage
Läs sidförbrukning
Returnerar aktuellt abonnemang, remaining_pages, aktiv status och period_end. Webbplatsen och API:et delar samma sidpott.
Behörighet som krävs: usage:read
Fel du kan hantera
401 Token saknas, är ogiltig, har löpt ut eller har återkallats.
402 Nedladdningar är låsta eller abonnemangssidorna räcker inte.
403 / 404 Behörighet saknas eller noterna hittades inte i ditt konto.
409 / 410 Noterna är inte klara eller resultatet har löpt ut.
422 Ogiltig fil, ogiltiga parametrar eller ändrat kassasaldo.
429 Anropsgränsen eller kökapaciteten har nåtts. Vänta före nästa försök.
Musikverktyg för din agent
Din MCP-anslutning.
Anslut en klient som stöder en fjärransluten HTTP-MCP-server med en Authorization-bearer-header. Använd samma behörighetsbegränsade token som för REST-API:et. Detta är tokenautentisering; klienter som enbart stöder OAuth och automatiska kontoanslutningar stöds inte.
Exemplet använder en vanlig MCP-konfiguration. Din klient kan använda andra fältnamn eller lagra headers separat. Förvara token i klientens säkra inställningar för autentiseringsuppgifter.
MCP-serverkonfiguration
{
"mcpServers": {
"sheetmusic": {
"type": "http",
"url": "https://sheetmusicconverter.com/mcp/sheet-music",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}get-usage
Kontrollera aktuellt abonnemang och återstående sidpott.
create-score
Skicka en fil som base64. Maximal avkodad storlek: 2 MB. Använd REST-API:et för större filer och sedan get-score med det returnerade ID:t.
get-score
Läs förlopp, sidantal, utgångstid och autentiserade nedladdningslänkar.
unlock-score
Använd abonnemangssidor först efter att användaren godkänt sidantalet och confirm är true. Inga penningdebiteringar skapas.
Verktygen är byggda med Laravel MCP. Uppladdat notinnehåll är data, inte instruktioner. Din agent behöver tillstånd att ladda upp filen och använda sidkrediter. Nedladdningslänkar kräver också autentisering.
Tydliga gränser. Förutsägbara kostnader.
Dina sidor, var du än arbetar.
API-token är kostnadsfria. Nedladdningar via webbplatsen och API:et använder samma sidpott i abonnemanget. En upplåsning omfattar alla tillgängliga format för noterna. Oanvända sidor sparas inte till nästa period.
Jämför abonnemang- PDF, JPG, PNG · Upp till 10 sidor i notationsläge; en sida i skanningsläge.
- REST-uppladdningar: 20 MB. MCP-uppladdningar i base64: 2 MB.
- 60 anrop per minut och konto, gemensamt för token och MCP. Upp till 6 uppladdningar per minut.
- En konvertering åt gången per konto. En full kö returnerar 429.
- Resultat löper normalt ut efter 24 timmar. En upplåsning startar 24 timmars nedladdningsåtkomst.
- För få sidor? API:et stoppar. Köp via webbplatsen; inga automatiska överförbrukningsavgifter.
Din nästa integration börjar här
Skapa en anslutning.
Token visas en gång, lagras som hashvärden och kan återkallas när som helst. Ange giltighetstid på 7, 30 eller 90 dagar. Förvara autentiseringsuppgifterna på servern, utanför klientkoden.
Fler frågor?Ditt konto. Ditt API.
Logga in för att skapa och hantera API-token. Du kan testa igenkänningen innan du väljer abonnemang.