Jam Jam
Eine REST-API hinter genau derselben Engine
Die API liegt unter jam-jam.org/api/v1 und läuft mit derselben Pipeline wie die Web-App, die mobile App und jam-jam.org/app/convert: eine Datei, die über eines von beiden abgelegt wird, nimmt denselben Code-Pfad und liefert dasselbe Ergebnis. Die vollständige Dokumentation, mit echten curl- und Python-Beispielen und einer Möglichkeit, einen Schlüssel zu erzeugen, steht unter jam-jam.org/developers. Die maschinenlesbare OpenAPI-3.1-Spezifikation unter jam-jam.org/api/v1/openapi.json enthält eine empfohlene Aufrufreihenfolge für einen Agenten oder ein Skript, und jam-jam.org/llms.txt listet jede Fähigkeit unten für einen Assistenten auf, der sie direkt liest. Ein offizieller MCP-Server (Model Context Protocol), @jam-jam/convert-mcp, kapselt dieselbe API als fünf Werkzeuge, list_formats, convert_file, convert_text, get_job und get_usage, für MCP-fähige Agenten wie Claude Desktop, Claude Code oder Cursor.
Ein Schlüssel, ein Kontingent, und keine Warteschlange
Der Aufruf von GET /formats braucht keine Authentifizierung und liefert jedes Format, das dieser Server heute annimmt, mit seinen Größen- und Längengrenzen, damit ein Skript vorher prüfen kann. Alles andere erwartet einen Authorization: Bearer-Header, entweder ein Supabase-Sitzungstoken oder einen persönlichen API-Schlüssel mit dem Präfix jj_live_..., kostenlos erstellt unter Einstellungen > API-Schlüssel in der App. Ohne Schlüssel gilt ein Aufruf als anonym: 3 Konvertierungen pro gleitenden 24 Stunden. Ein kostenloses Konto hebt das auf 10 pro Woche an, dasselbe gleitende Kontingent, das sich Import und Export des Notizbuchs schon teilen; Premium hebt es auf 500 pro Monat an. Jede Antwort, die Kontingent verbraucht, trägt X-Quota-*-Header mit dem genauen Stand, und sowohl hochgeladene Dateien als auch Ergebnisse werden 24 Stunden nach Erstellung des Jobs gelöscht, egal ob er gelingt oder scheitert.
Einen Job abschicken, dann abfragen oder streamen
Eine Konvertierung ist ein Job, keine sofortige Antwort: POST /jobs mit einer Datei als multipart/form-data, oder einer URL oder eingefügtem Text als JSON, liefert ein 202 mit der Job-ID. Von dort fragt GET /jobs/{id} den Status ab (unter Beachtung des Retry-After-Headers), oder GET /jobs/{id}/events öffnet einen Server-Sent-Events-Stream desselben Jobs für ein Skript, das lieber wartet als nachfragt. Sobald die Phase done erreicht, lädt GET /jobs/{id}/result die fertige Datei herunter, und GET /jobs/{id}/result/songbook liefert dasselbe Ergebnis wie Jam Jams eigener JSON-Pivot, Akkorde, Songtext, Abschnitte, Tonart, Tempo, direkt lesbar. Jeder Fehler kommt als standardmäßiger application/problem+json-Body zurück statt als bloßer Statuscode.
Rein: eine Aufnahme, ein Link, ein Scan oder ein Foto
Eine Audio- oder Videodatei wird zu einem Notizbuch mit bereits bestimmten Akkorden, Songtext, Tonart und Tempo, derselben Erkennung, die die App bei einem Live-Mikrofon oder einer hochgeladenen Aufnahme durchführt, und von dort kann es direkt in ein erzeugtes Karaoke-Video oder eine Begleitspur gehen. Eine per URL eingefügte Seite, oder eine Suchanfrage, wird genauso gelesen wie eine Tabulatur-Seite in der App. Ein PDF oder ein Foto, ein gedrucktes Akkordblatt, eine gescannte Partitur, ein ganzes Notizbuch, eine Gitarrentabulatur, sogar das Handyfoto einer Tafel, geht über OCR und optische Notenerkennung in denselben Pivot. Rohes Audio selbst in Notation, ein Notenblatt oder eine Tabulatur zu verwandeln, bleibt vorerst hinter einem Qualitätsfilter: diese Richtung braucht eine Quelle, die die Melodie schon trägt, keine Live-Aufnahme.
Rein: Text und Notation, die du schon hast
ChordPro- und OnSong-Dateien, reiner Text mit Akkorden oder Songtext oder einer ASCII-Tabulatur, ein Word- oder RTF-Dokument, Präsentationsfolien, eine Tabellenkalkulation oder eine Setlist als CSV, und das HTML einer eingefügten Webseite konvertieren sich alle in dasselbe Notizbuch, weil ein Akkordblatt selten in nur einer Form ankommt. MusicXML- und MIDI-Dateien bringen ihre eigenen Noten mit und, wenn vorhanden, ihren Songtext; eine Guitar-Pro- oder MuseScore-Projektdatei (.gp, .gpx, .mscz und verwandte Endungen) erreicht das Notizbuch auf demselben Weg, in Beta; eine Datei mit synchronisiertem Songtext (.lrc, .srt, .vtt, .ass) bringt ihr Timing mit; und eine .jamsong-Datei oder ein gezippter Export wird verlustfrei re-importiert, genau so, wie er Jam Jam verlassen hat.
Raus: welches Format der Job wirklich braucht
Aus demselben Notizbuch exportiert die API ein PDF der Akkorde, des Songtexts oder eines leeren Rasters; ein PNG-Bild, eine HTML-Seite, reinen Text, ChordPro, eine chords-lab- oder chords-csv-Akkordannotation, oder nur Tonart und Tempo; eine transponierte Version oder eine mit Kapodaster; Akkorddiagramme für Gitarre, Ukulele, Klavier und die anderen Instrumente, die Jam Jam abdeckt; synchronisierten Songtext als .lrc oder .srt; ein Karaoke-Video; eine erzeugte Begleitspur; oder die verlustfreie .jamsong-Datei, auf Wunsch druckfertig. Sobald tatsächlich eine Melodie vorliegt, importiert aus MusicXML, MIDI, einem Guitar-Pro-Projekt, einer gescannten Partitur oder einer Tabulatur statt aus rohem Audio, exportiert dasselbe Notizbuch auch als Notenblatt, als Gitarren-Tabulatur-PDF, als MIDI oder als MusicXML, die letzten beiden mit Premium.
Für den Gesamtüberblick über Jam Jams Konvertierungs-Pipeline, lies den Artikel zur universellen Dateikonvertierung.
Häufige Fragen zur API
Was ist die Jam Jam API?
Eine öffentliche REST-API unter jam-jam.org/api/v1, die Jam Jams eigene Konvertierungs-Engine antreibt: schick ihr eine Audiodatei, ein PDF, ein Foto, einen Link, MIDI, MusicXML, ChordPro oder reinen Text, und bekomm ein strukturiertes Notizbuch (Akkorde, Songtext, Tonart, Tempo) oder einen portablen Export wie ein PDF, ein Karaoke-Video oder eine Begleitspur zurück.
Ist die API kostenlos?
Ja, bis zu einem Kontingent. Anonyme Aufrufe bekommen 3 Konvertierungen pro gleitenden 24 Stunden, ein kostenloses Konto 10 pro Woche, und Premium hebt das auf 500 pro Monat an. Hochgeladene Dateien und Ergebnisse werden 24 Stunden nach Ausführung des Jobs gelöscht.
Kann die API eine Audiodatei in Akkorde und Songtext umwandeln?
Ja. Eine Audio- oder Videodatei mit output: songbook abzuschicken liefert zeitgestempelte Akkorde, die Tonart, das Tempo und den Songtext, dieselbe Erkennung, die die App selbst durchführt. Vollständige Melodie-Notation aus rohem Audio (MIDI, MusicXML, ein Notenblatt oder eine Tabulatur) gehört nicht dazu: dafür braucht es eine Quelle, die die Melodie schon trägt.
Gibt es einen MCP-Server für KI-Agenten?
Ja, @jam-jam/convert-mcp stellt dieselbe API als fünf Werkzeuge bereit, list_formats, convert_file, convert_text, get_job und get_usage, damit ein MCP-fähiger Agent wie Claude Desktop, Claude Code oder Cursor sie direkt aufrufen kann.
Wo bekomme ich einen API-Schlüssel?
Erstell ein kostenloses Jam-Jam-Konto, öffne dann Einstellungen > API-Schlüssel in der App (mobil oder web) und erzeuge einen. Er wird nur einmal angezeigt, beginnt mit jj_live_, und kann jederzeit widerrufen werden; bis zu 5 Schlüssel pro Konto.
Lies die vollständige Referenz, mit echten curl- und Python-Beispielen, unter jam-jam.org/developers: