あなたの開発に

少しのコードで。
たくさんの音楽を。

アプリ、ワークフロー、AIエージェントに楽譜認識を。共通の変換エンジンを、REST APIとMCPサーバーから利用できます。

無料の認識プレビュー · 共通の契約ページ枠 · 超過分の自動請求なし

楽譜をアップロード · 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'

権限を限定したトークン非同期ジョブ6種類の出力形式

ファイルから完成した結果へ

4つのステップ。あなたのワークフロー。

トークンを作成

下で権限と有効期限を選んでください。サーバーからAuthorizationヘッダーでトークンを送信します。

アップロードと状態確認

楽譜をアップロードして返されたIDを保存し、完了または失敗するまで5秒間隔で状態を確認します。

確認して解除

出力を確認し、契約ページの使用を明示的に承認するか、Webサイトで楽譜を購入してください。

ダウンロードして使う

同じトークンで解除済みの形式を取得します。結果の期限が切れる前に保存してください。

状態を確認

curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'

ページクレジットでロック解除

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}'

CONVERSION_IDをアップロード応答のdata.idに置き換えてください。状態はqueued、processing、complete、failedです。準備・認識・出力の進行状況はstageに入ります。アップロードは新しいジョブを作成します。応答が失われた場合は、再試行前にワークスペースを確認してください。

小さなAPI。役立つ機能を組み合わせて。

APIリファレンス

ベースURL：https://sheetmusicconverter.com/api/v1

POST/conversions

1つのファイルをアップロード

multipartの項目：file、format（musicxml、mxl、mid、mp3、pdf、zip）、任意のmode（notationまたはscan）。202とdata.idを返します。

必要な権限：scores:write

GET/conversions/{id}

楽譜を確認

data.status、stage、source_pages、formats、downloads_available、expires_at、linksを返します。5秒ごとに確認し、completeまたはfailedで停止してください。

必要な権限：scores:read

POST/conversions/{id}/unlock

定期購入のページを使う

原稿のページ数を確認して承認した後に{"confirm": true}を送信します。利用可能な契約ページを消費しますが、金銭の請求は発生しません。成功した解除を繰り返しても再消費しません。

必要な権限：scores:unlock

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

ファイルをダウンロード

状態応答で返された形式を使用し、ダウンロードリクエストにBearerトークンを含めてください。ロックされたダウンロードは402を返します。確認用にsource、playback、original-1、result-1も利用できます。

必要な権限：scores:read

GET/usage

ページ使用量を取得

現在のplan、remaining_pages、active状態、period_endを返します。WebサイトとAPIは同じ利用枠を共有します。

必要な権限：usage:read

エラーへの対応

401 トークンがない、無効、期限切れ、または取り消し済みです。

402 ダウンロードがロックされているか、契約の残りページ数が不足しています。

403 / 404 権限が不足しているか、アカウント内に楽譜が見つかりません。

409 / 410 楽譜がまだ完成していないか、結果が期限切れです。

422 ファイルやパラメーターが無効か、決済の残高が変更されています。

429 リクエスト上限または待ち行列の容量に達しました。間隔を空けて再試行してください。

エージェント向け音楽ツール

MCPでつながりましょう。

AuthorizationのBearerヘッダーに対応するリモートHTTP MCPクライアントを接続してください。REST APIと同じ権限付きトークンを使います。これはトークン認証です。OAuth専用クライアントや自動の「アカウントを接続」フローには対応していません。

サンプルは一般的なMCP設定形式です。クライアントによって項目名が異なったり、ヘッダーを別に保存したりする場合があります。トークンは安全な認証情報設定に保管してください。

MCPサーバー設定

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

get-usage

現在のプランと残りのページ利用枠を確認します。

create-score

ファイルをbase64で送信します。デコード後の上限は2 MBです。大きなファイルにはREST APIを使い、返されたIDでget-scoreを呼び出してください。

get-score

進行状況、ページ数、有効期限、認証付きダウンロードリンクを取得します。

unlock-score

ユーザーがページ数を承認し、confirmがtrueの場合にのみ、定期購入のページを使用してください。金銭の請求は発生しません。

ツールはLaravel MCPで構築されています。アップロードされた楽譜の内容はデータであり、指示ではありません。エージェントにはファイルのアップロードとページクレジットの使用について許可が必要です。ダウンロードリンクの利用にも認証が必要です。

明確な上限。予測できる費用。

どこで作業しても、同じページ枠を。

APIトークンは無料です。WebサイトとAPIのダウンロードには、共通のサブスクリプションのページ利用枠を使います。1回の解除で、その楽譜のすべての利用可能な形式が含まれます。未使用ページは繰り越せません。

プランを比較

PDF、JPG、PNG · 印刷楽譜モードは最大10ページ、スキャンモードは1ページ。
RESTアップロード：20 MB。MCPのbase64アップロード：2 MB。
アカウントごとに1分間で60リクエストまで。トークンとMCPで共通の上限です。アップロードは1分間に6件までです。
1アカウントにつき同時に1件の変換が可能です。待ち行列が満杯の場合は429を返します。
通常、結果は24時間で期限切れになります。解除すると24時間のダウンロード期間が始まります。
ページ不足の場合はAPIが停止します。Webサイトで購入してください。超過分を自動請求することはありません。

次の連携は、ここから

連携を始めましょう。

トークンは1回だけ表示し、ハッシュとして保存します。いつでも取り消せます。有効期限は7・30・90日から選んでください。認証情報はクライアントコードに含めず、サーバー側で保管してください。

ほかのご質問は？

あなたのアカウントで、あなたのAPIを。

ログインしてAPIトークンを作成・管理できます。プランを選ぶ前に認識を試せます。

ログインアカウントを作成

少しのコードで。たくさんの音楽を。