Voor wat jij bouwt

Een beetje code.
Heel veel muziek.

Voeg bladmuziekherkenning toe aan je app, werkwijze of AI-agent. Eén conversie-engine. Een REST-API en een MCP-server.

Haal je API-token opVerbind een agent

Gratis herkenningsvoorbeelden · Gedeelde abonnementspagina's · Geen automatische overschrijdingskosten

Een partituur uploaden · 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 met beperkte machtigingenAsynchrone taken6 uitvoerformaten

Van bestand naar eindresultaat

Vier stappen. Jouw werkwijze.

01

Een token aanmaken

Kies hieronder machtigingen en een vervaldatum. Verstuur het token vanaf je server in de Authorization-header.

02

Uploaden en status opvragen

Upload een partituur. Bewaar de geretourneerde ID en controleer elke vijf seconden de status totdat deze complete of failed is.

03

Bekijken en ontgrendelen

Controleer de uitvoer. Geef uitdrukkelijk toestemming om abonnementspagina's te gebruiken of betaal voor de partituur op de website.

04

Downloaden en gebruiken

Haal een ontgrendeld formaat op met hetzelfde token. Bewaar je bestanden voordat het resultaat verloopt.

Status controleren
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
Ontgrendelen met paginategoed
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}'

Vervang CONVERSION_ID door data.id uit het uploadantwoord. Statussen zijn queued, processing, complete of failed. De voortgang van voorbereiding, herkenning en export staat in stage. Uploads maken nieuwe taken aan: als een antwoord verloren gaat, controleer dan eerst je werkplek voordat je opnieuw uploadt.

Een kleine API. Handige bouwstenen.

API-referentie

Basis-URL: https://sheetmusicconverter.com/api/v1

POST/conversions

Eén bestand uploaden

Multipart-velden: file, format (musicxml, mxl, mid, mp3, pdf, zip) en optioneel mode (notation of scan). Retourneert 202 en data.id.

Vereiste machtiging: scores:write

GET/conversions/{id}

Controleer je partituur

Retourneert data.status, stage, source_pages, formats, downloads_available, expires_at en links. Controleer elke 5 seconden; stop bij complete of failed.

Vereiste machtiging: scores:read

POST/conversions/{id}/unlock

Abonnementspagina's gebruiken

Verstuur {"confirm": true} nadat je het aantal bronpagina's hebt goedgekeurd. Dit gebruikt beschikbaar abonnementstegoed en brengt nooit geld in rekening. Het herhalen van een geslaagde ontgrendeling gebruikt geen extra tegoed.

Vereiste machtiging: scores:unlock

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

Een bestand downloaden

Gebruik een formaat uit het statusantwoord. Voeg je bearertoken toe aan het downloadverzoek. Vergrendelde downloads retourneren 402. source, playback, original-1 en result-1 zijn ook beschikbaar voor controle.

Vereiste machtiging: scores:read

GET/usage

Paginagebruik bekijken

Retourneert het huidige abonnement, remaining_pages, de actieve status en period_end. Website en API delen hetzelfde tegoed.

Vereiste machtiging: usage:read

Fouten die je kunt afhandelen

401 Token ontbreekt, is ongeldig, verlopen of ingetrokken.

402 Downloads zijn vergrendeld of je hebt onvoldoende abonnementspagina's.

403 / 404 Machtiging ontbreekt of de partituur is niet gevonden in je account.

409 / 410 Partituur nog niet gereed of resultaat verlopen.

422 Ongeldig bestand, ongeldige parameters of gewijzigd saldo bij het afrekenen.

429 Verzoeklimiet of wachtrijcapaciteit bereikt. Wacht voordat je het opnieuw probeert.

Muziektools voor je agent

Maak kennis met je MCP-verbinding.

Verbind een client die een externe HTTP-MCP-server met een Authorization-bearerheader ondersteunt. Gebruik hetzelfde token met beperkte machtigingen als voor de REST-API. Dit is tokenauthenticatie; clients die uitsluitend OAuth gebruiken en automatische ‘Account verbinden’-processen worden niet ondersteund.

Het voorbeeld gebruikt een gangbare MCP-configuratiestructuur. Je client kan andere veldnamen gebruiken of headers apart bewaren. Bewaar je token in de beveiligde instellingen voor inloggegevens.

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

get-usage

Bekijk je huidige abonnement en resterende paginategoed.

create-score

Verstuur een bestand als base64. Maximale gedecodeerde grootte: 2 MB. Gebruik voor grotere bestanden de REST-API en daarna get-score met de geretourneerde ID.

get-score

Lees voortgang, pagina-aantal, vervaldatum en geauthenticeerde downloadlinks.

unlock-score

Gebruik abonnementspagina's alleen nadat de gebruiker het pagina-aantal heeft goedgekeurd en confirm op true staat. Er worden geen geldbedragen in rekening gebracht.

Tools zijn gebouwd met Laravel MCP. Geüploade partituurinhoud is data, geen instructie. Je agent heeft toestemming nodig om het bestand te uploaden en paginategoed te gebruiken. Downloadlinks vereisen ook authenticatie.

Duidelijke limieten. Voorspelbare kosten.

Je pagina's, waar je ook werkt.

API-tokens zijn gratis. Downloads via de website en API gebruiken hetzelfde paginategoed van je abonnement. Eén ontgrendeling omvat alle beschikbare formaten voor die partituur. Ongebruikte pagina's vervallen.

Abonnementen vergelijken
  • PDF, JPG, PNG · Tot 10 pagina's in notatiemodus; één pagina in scanmodus.
  • REST-uploads: 20 MB. MCP-base64-uploads: 2 MB.
  • 60 verzoeken per minuut per account, gedeeld door alle tokens en MCP. Maximaal 6 uploads per minuut.
  • Eén conversie tegelijk per account. Een volle wachtrij retourneert 429.
  • Resultaten verlopen normaal gesproken na 24 uur. Ontgrendelen start een downloadperiode van 24 uur.
  • Onvoldoende pagina's? De API stopt. Koop via de website; er zijn geen automatische overschrijdingskosten.

Je volgende integratie begint hier

Maak een verbinding.

Tokens worden eenmaal getoond, als hashes opgeslagen en kunnen op elk moment worden ingetrokken. Stel een vervaldatum van 7, 30 of 90 dagen in. Bewaar inloggegevens op je server, buiten clientcode.

Meer vragen?

Je account. Je API.

Meld je aan om API-tokens aan te maken en te beheren. Je kunt de herkenning testen voordat je een abonnement kiest.

AanmeldenAccount aanmaken