Für das, was du entwickelst

Ein wenig Code.
Jede Menge Musik.

Integriere Notenerkennung in deine App, deinen Arbeitsablauf oder deinen KI-Agenten. Eine Konvertierungsengine. Eine REST-API und ein MCP-Server.

Hol dir deinen API-TokenEinen Agenten verbinden

Kostenlose Erkennungsvorschauen · Gemeinsames Seitenkontingent · Keine automatischen Mehrkosten

Partitur hochladen · 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 mit begrenzten BerechtigungenAsynchrone Aufträge6 Ausgabeformate

Von der Datei zum fertigen Ergebnis

Vier Schritte. Dein Arbeitsablauf.

01

Einen Token erstellen

Wähle unten Berechtigungen und Ablaufdatum. Sende den Token im Authorization-Header von deinem Server.

02

Hochladen & Status abfragen

Lade eine Partitur hoch. Speichere die zurückgegebene ID und frage den Status alle fünf Sekunden ab, bis complete oder failed erreicht ist.

03

Prüfen & freischalten

Prüfe das Ergebnis. Bestätige ausdrücklich den Einsatz von Abonnementseiten oder bezahle die Partitur auf der Website.

04

Herunterladen & verwenden

Rufe ein freigeschaltetes Format mit demselben Token ab. Speichere deine Dateien, bevor das Ergebnis abläuft.

Status prüfen
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
Mit Seitenguthaben freischalten
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}'

Ersetze CONVERSION_ID durch data.id aus der Uploadantwort. Statuswerte: queued, processing, complete oder failed. Vorbereitungs-, Erkennungs- und Exportfortschritt stehen in stage. Uploads erstellen neue Aufträge: Geht eine Antwort verloren, prüfe deinen Arbeitsbereich vor einem erneuten Versuch.

Kleine API. Nützliche Bausteine.

API-Referenz

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

POST/conversions

Eine Datei hochladen

Multipart-Felder: file, format (musicxml, mxl, mid, mp3, pdf, zip) und optional mode (notation oder scan). Gibt 202 und data.id zurück.

Erforderliche Berechtigung: scores:write

GET/conversions/{id}

Deine Partitur prüfen

Gibt data.status, stage, source_pages, formats, downloads_available, expires_at und links zurück. Alle 5 Sekunden abfragen; bei complete oder failed stoppen.

Erforderliche Berechtigung: scores:read

POST/conversions/{id}/unlock

Abonnementseiten verwenden

Sende {"confirm": true}, nachdem du die Originalseitenzahl genehmigt hast. Verbraucht vorhandenes Abonnementguthaben; erzeugt niemals eine Geldabbuchung. Eine erfolgreiche Freischaltung erneut auszuführen verbraucht kein weiteres Guthaben.

Erforderliche Berechtigung: scores:unlock

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

Eine Datei herunterladen

Verwende ein Format aus der Statusantwort. Sende deinen Bearer-Token bei der Downloadanfrage mit. Gesperrte Downloads geben 402 zurück. source, playback, original-1 und result-1 stehen ebenfalls zur Prüfung bereit.

Erforderliche Berechtigung: scores:read

GET/usage

Seitenverbrauch lesen

Gibt den aktuellen Tarif, remaining_pages, aktiven Status und period_end zurück. Website und API teilen dasselbe Kontingent.

Erforderliche Berechtigung: usage:read

Fehler, die du behandeln kannst

401 Token fehlt, ist ungültig, abgelaufen oder widerrufen.

402 Downloads gesperrt oder nicht genügend Abonnementseiten.

403 / 404 Berechtigung fehlt oder Partitur nicht in deinem Konto gefunden.

409 / 410 Partitur noch nicht fertig oder Ergebnis abgelaufen.

422 Ungültige Datei, Parameter oder veränderter Betrag beim Bezahlen.

429 Anfragelimit oder Warteschlangenkapazität erreicht. Warte vor einem erneuten Versuch.

Musiktools für deinen Agenten

Deine MCP-Verbindung.

Verbinde einen Client, der einen entfernten HTTP-MCP-Server mit Authorization-Bearer-Header unterstützt. Verwende denselben eingeschränkten Token wie für die REST-API. Dies ist Token-Authentifizierung; reine OAuth-Clients und automatische Kontoverknüpfungen werden nicht unterstützt.

Das Beispiel verwendet eine gängige MCP-Konfigurationsstruktur. Dein Client kann andere Feldnamen verwenden oder Header separat speichern. Bewahre deinen Token in den sicheren Anmeldedateneinstellungen auf.

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

get-usage

Prüfe den aktuellen Tarif und das verbleibende Seitenkontingent.

create-score

Übermittle eine Datei als Base64. Maximale dekodierte Größe: 2 MB. Für größere Dateien verwende die REST-API und anschließend get-score mit der zurückgegebenen ID.

get-score

Lies Fortschritt, Seitenzahl, Ablaufdatum und authentifizierte Downloadlinks.

unlock-score

Verwende Abonnementseiten erst, nachdem der Nutzer die Seitenzahl genehmigt hat und confirm true ist. Es entstehen keine Geldabbuchungen.

Die Tools nutzen Laravel MCP. Hochgeladene Partiturinhalte sind Daten, keine Anweisungen. Dein Agent benötigt die Erlaubnis zum Upload und zum Verbrauch von Seitenguthaben. Auch Downloadlinks erfordern Authentifizierung.

Klare Grenzen. Vorhersehbare Kosten.

Deine Seiten, überall dort, wo du arbeitest.

API-Tokens sind kostenlos. Downloads über Website und API nutzen dasselbe Seitenkontingent deines Abonnements. Eine Freischaltung enthält jedes verfügbare Format der Partitur. Ungenutzte Seiten werden nicht übertragen.

Tarife vergleichen
  • PDF, JPG, PNG · Bis zu 10 Seiten im Notationsmodus; eine Seite im Scanmodus.
  • REST-Uploads: 20 MB. MCP-Base64-Uploads: 2 MB.
  • 60 Anfragen pro Minute und Konto, gemeinsam für Tokens und MCP. Bis zu 6 Uploads pro Minute.
  • Eine Konvertierung gleichzeitig pro Konto. Eine volle Warteschlange gibt 429 zurück.
  • Ergebnisse laufen normalerweise nach 24 Stunden ab. Eine Freischaltung startet ein Downloadfenster von 24 Stunden.
  • Nicht genügend Seiten? Die API stoppt. Kaufe über die Website; keine automatischen Mehrkosten.

Deine nächste Integration beginnt hier

Eine Verbindung schaffen.

Tokens werden einmal angezeigt, als Hash gespeichert und können jederzeit widerrufen werden. Wähle eine Gültigkeit von 7, 30 oder 90 Tagen. Bewahre Zugangsdaten auf deinem Server außerhalb des Clientcodes auf.

Weitere Fragen?

Dein Konto. Deine API.

Melde dich an, um API-Tokens zu erstellen und zu verwalten. Du kannst die Erkennung vor der Tarifwahl testen.

AnmeldenKonto erstellen