Jam Jam
まったく同じエンジンを使うREST API
APIはjam-jam.org/api/v1にあり、ウェブアプリ、モバイルアプリ、jam-jam.org/app/convertとまったく同じ処理を実行します。どこから送っても同じコードを通り、同じ結果になります。実際のcurlとPythonのサンプルとキーの発行方法を含む完全なドキュメントはjam-jam.org/developersにあります。機械可読なOpenAPI 3.1仕様書（jam-jam.org/api/v1/openapi.json）にはエージェントやスクリプト向けの推奨呼び出し手順が埋め込まれており、jam-jam.org/llms.txtは以下の機能をすべて、直接読み取るアシスタント向けに列挙しています。公式のMCP（Model Context Protocol）サーバー@jam-jam/convert-mcpは、同じAPIをlist_formats、convert_file、convert_text、get_job、get_usageという5つのツールとして公開し、Claude Desktop、Claude Code、CursorなどMCP対応エージェントから利用できます。
キーと利用上限、待ち行列なし
GET /formatsの呼び出しは認証なしで使え、このサーバーが現在対応しているすべての形式を、サイズや長さの上限とともに返します。スクリプトはアップロード前に確認できます。それ以外はすべてAuthorization: Bearerヘッダーが必要で、Supabaseのセッショントークンか、jj_live_で始まる個人用APIキー（アプリ内の設定 > APIキーで無料で作成）のどちらかを使います。キーなしの呼び出しは匿名扱いになり、変動する24時間ごとに3回までの変換が可能です。無料アカウントならソングブックの書き出しや読み込みですでに使われているのと同じ週10回の上限に上がり、Premiumなら月500回まで上がります。利用上限を消費する応答にはすべてX-Quota-*ヘッダーが付き、正確な残量がわかります。アップロードしたファイルと結果は、成功しても失敗してもジョブ作成から24時間後に削除されます。
ジョブを送信し、ポーリングかストリームで追う
変換は即答ではなくジョブです。POST /jobsにファイルをmultipart/form-data、またはURLや貼り付けたテキストをJSONで送ると、ジョブIDを含む202が返ります。そこからGET /jobs/{id}で状態をポーリングする（Retry-Afterヘッダーを守る）か、GET /jobs/{id}/eventsで同じジョブのServer-Sent Eventsストリームを開き、問い合わせるより待つほうがよいスクリプトに対応します。phaseがdoneになったら、GET /jobs/{id}/resultで完成したファイルをダウンロードするか、GET /jobs/{id}/result/songbookでJam Jam独自のJSONピボット（コード、歌詞、セクション、調、テンポ）をそのまま読み取れます。エラーはすべて単なるステータスコードではなく、標準のapplication/problem+json形式で返ります。
入力：録音、リンク、スキャン、写真
音声やビデオファイルは、コード、歌詞、調、テンポがすでに解析されたソングブックになります。アプリがマイクの生音やアップロードされたファイルに対して行うのと同じ検出です。そこから直接、生成されたカラオケ動画や伴奏トラックに進めます。URLで貼り付けたページや検索クエリは、アプリ内のタブサイトと同じように読み取られます。PDFや写真、印刷されたコード譜、スキャンした楽譜、ソングブック全体、ギタータブ、スマホで撮ったホワイトボードの写真さえも、OCRと光学楽譜認識を通じて同じピボットになります。生の音声そのものを譜面やタブに変換することは、今のところ品質のゲートの先にあり、その方向にはライブ録音ではなく、すでにメロディーを持つ入力が必要です。
入力：すでに持っているテキストや譜面
ChordProやOnSongファイル、コードや歌詞を含む普通のテキスト、ASCIIタブ、Word・RTF文書、プレゼンテーションのスライド、表計算ソフトやCSVのセットリスト、貼り付けたウェブページのHTML、これらはすべて同じソングブックに変換されます。コード譜は一つの形だけで届くとは限らないからです。MusicXMLとMIDIファイルは自身の音符と、あれば歌詞を持ち込みます。Guitar ProやMuseScoreのプロジェクトファイル（.gp、.gpxおよび関連拡張子や.mscz）も同じようにソングブックに届きます（ベータ版）。同期歌詞ファイル（.lrc、.srt、.vtt、.ass）はタイミングを持ち込み、.jamsongファイルやzip書き出しはJam Jamを離れたときとまったく同じ形で、劣化なく再インポートされます。
出力：ジョブが本当に必要とする形式なら何でも
同じソングブックから、APIはコードのPDF、歌詞のPDF、空のグリッド、PNG画像、HTMLページ、プレーンテキスト、ChordPro、chords-labやchords-csvのコード注釈、あるいは調とテンポだけを書き出せます。移調版やカポ版、ギター・ウクレレ・ピアノなどJam Jamが対応する楽器のコードダイアグラム、.lrcや.srtの同期歌詞、カラオケ動画、生成された伴奏トラック、劣化のない.jamsongファイル（依頼すれば印刷用レイアウトも）も可能です。MusicXML、MIDI、Guitar Proプロジェクト、スキャンした楽譜、タブなど、生の音声ではなくメロディーをすでに含むソースから取り込んだ場合には、同じソングブックが楽譜、ギタータブPDF、MIDI、MusicXML（後者2つはPremium）としても書き出せます。
Jam Jamの変換パイプライン全体については、こちらをご覧ください： ファイル変換の全体像を紹介する記事。
APIに関するよくある質問
Jam Jam APIとは何ですか？
jam-jam.org/api/v1にある公開REST APIで、Jam Jam独自の変換エンジンを実行します。音声ファイル、PDF、写真、リンク、MIDI、MusicXML、ChordPro、プレーンテキストなどを送ると、構造化されたソングブック（コード、歌詞、調、テンポ）や、PDF、カラオケ動画、伴奏トラックといった各種出力形式が返ってきます。
APIは無料で使えますか？
はい、利用上限の範囲内で無料です。匿名の呼び出しは変動する24時間ごとに3回、無料アカウントは週10回、Premiumなら月500回まで利用できます。アップロードしたファイルと結果はジョブ実行から24時間後に削除されます。
APIは音声ファイルをコードと歌詞に変換できますか？
はい。音声やビデオファイルをoutput: songbookで送信すると、タイムスタンプ付きのコード、調、テンポ、歌詞が返ってきます。アプリ自体が実行するのと同じ検出です。生の音声からの完全なメロディー譜面化（MIDI、MusicXML、五線譜、タブ）はこれには含まれず、すでにメロディーを持つソースが必要です。
AIエージェント向けのMCPサーバーはありますか？
はい。@jam-jam/convert-mcpが同じAPIをlist_formats、convert_file、convert_text、get_job、get_usageという5つのツールとして公開しており、Claude Desktop、Claude Code、CursorなどMCP対応エージェントから直接呼び出せます。
APIキーはどこで取得できますか？
無料のJam Jamアカウントを作成し、アプリ（モバイルまたはウェブ）内の設定 > APIキーを開いて生成してください。表示は一度限りで、jj_live_で始まり、いつでも無効化できます。アカウントごとに最大5個まで発行できます。
実際のcurlとPythonのサンプルを含む完全なリファレンスはjam-jam.org/developersで：