· reAPI Team
Suno MIDI のインポートとエクスポート:要件と API ガイド
Suno MIDI のインポート・エクスポートガイド:V6_WILD のファイル要件、最短 6 秒の再生時間、ステムから MIDI JSON への API ワークフロー、現在のリクエスト単価。

Suno MIDI は現在双方向で動作しますが、技術的なルールは方向ごとに異なります。2026 年 11 月 4 日、Suno は Create ページに MIDI ファイルのアップロード機能を直接追加し、Pro および Premier プランの契約者がテキストプロンプトだけに頼らず .mid または .midi ファイルから V6 の楽曲を始められるようにしました[1]。逆方向、つまり AI 生成トラックを編集可能なノートデータへ戻す場合、Suno Studio 内で Get MIDI をクリックするにしても[2]、Suno MIDI API を通じて 2 つのエンドポイントを連結するにしても[4]、最初にステム分離を行う必要があります。
多くの記事は Suno MIDI を単一のエクスポートボタンとして扱うか、一般的な DAW のミキシング助言にとどめています。オーディオツールを構築している場合や、DAW と Suno の間でスケッチを行き来させている場合、実際の障壁は制約条件にあります。どのモデルバージョンが Suno MIDI インポートを実行するのか、構文上有効な .mid ファイルがレンダリング前に拒否されるのはなぜか、API 抽出がバイナリの .mid ダウンロードではなくノート JSON を返す仕組み、そして各ステップにいくらかかるのか。以下では、Suno の現行ドキュメントと、2026 年 11 月 19 日に当社が実施した本番 API テスト実行の結果を組み合わせて解説します。
2 つの Suno MIDI ワークフローとそれぞれの適性
統合コードを書いたり月額 Studio プランを契約したりする前に、2 つの方向を切り分けておきます。Suno MIDI インポートは無音のノートシーケンスを完全なアレンジへ変換するため、初期デモのために何ギガバイトものサンプルライブラリを読み込む代わりとして素早く使えます。Suno MIDI エクスポートはその逆で、分離済みステムからピッチ、タイミング、ベロシティのデータを復元し、Logic、Ableton、FL Studio、MuseScore でシンセを差し替えたり、コードボイシングを確認したり、パートを組み直したりできるようにします。
| ワークフローの詳細 | Suno Web アプリ / Studio(UI) | reAPI HTTP API(/api/v1/audio/generations) |
|---|---|---|
| MIDI から楽曲を開始 | .mid / .midi を Create にドラッグ(Simple モード、v6-wild、Pro/Premier プラン)[1] | model: "suno-music"、custom_mode: false、version: "V6_WILD"、midi_urls(公開 URL 1 件)[4] |
| ライブピアノロールと USB コントローラー | Web MIDI API 対応の Studio ネイティブ MIDI トラック(Chrome、Safari は Web MIDI 非対応)[3] | 該当なし(ステートレスな REST タスクパイプライン) |
| 楽曲から MIDI を抽出 | Studio でステムを抽出し、ステムを右クリックして Get MIDI を選択(10 Suno クレジット)[2] | ステップ 1:suno-vocal-separation(生成済みトラックまたは外部 audio_url)。ステップ 2:分離タスクの task_id に対して suno-midi を実行[4] |
| エクスポートされる MIDI 形式 | 標準 .mid ファイルのダウンロード[2] | 構造化 JSON(pitch、start、end、velocity を持つ instruments[].notes[])[4] |
| 料金体系(2026 年 11 月 19 日確認) | サブスクリプションプラン(Pro / Premier)+ Suno クレジット残高[1][2] | reAPI Suno の固定リクエスト単価:楽曲生成 $0.06、ステム分離 $0.05〜$0.25、MIDI 抽出 $0.001[5] |
USB キーボードでライブ演奏したり、ブラウザのピアノロールでノートをクオンタイズしたり、オーディオタイムライン上でテイクをコンピングしたりしたい場合は、Suno Studio が適した環境です。Safari は現在 Web MIDI に対応していないため、Suno は Studio でハードウェアコントローラーを使う際に Google Chrome を推奨しています[3]。バッチ処理、アプリ統合、または月額シートなしの従量課金が必要な場合は、Suno MIDI API の方がずっと簡単に自動化できます。
Suno MIDI の要件と API 経由での .mid ファイルのインポート
標準 MIDI ファイル(Standard MIDI File)自体に音は含まれません。Suno が 2026 年 11 月 4 日の発表で説明しているとおり、.mid または .midi ファイルは最大 16 チャンネルのピッチおよびタイミングイベントを保持でき、各チャンネルにはサステイン、ボリューム、モジュレーションなどのパラメーター用に最大 120 のコントローラーレーンがあります[1]。そのファイルを Suno に入力すると、モデルに正確なノートタイミングと和声進行が渡され、出力が譜面にどれだけ厳密に従うかはプロンプトで制御できます。たとえば、コードをそのまま弦楽四重奏で演奏させることも、短いモチーフを借りて新しいジャンルへ発展させることもできます[1]。
ローンチ時点で、Suno MIDI インポートは V6_WILD 上の Simple(インスピレーション)モードで動作します[1]。reAPI では、model: "suno-music" に custom_mode: false、version: "V6_WILD"、そして公開 HTTP(S) URL を 1 件含む midi_urls を指定する形に対応します[4]。midi_urls と合わせて別のバージョンを送った場合、アップストリーム側で実行が V6_WILD に切り替わります[4]。Base64 や data: URI はプラットフォーム全体で拒否されるため、生成エンドポイントを呼び出す前に .mid ファイルを公開オブジェクトストレージへホストする(またはプレイグラウンドの suno-midi アップローダーでアップロードする)必要があります[4]。
正確なファイルおよびペイロード制限
すべての Suno MIDI インポートリクエストは、モデルが音声をレンダリングする前に 5 つの Suno MIDI 要件を満たす必要があります。
- 形式:
MThdヘッダーで始まる標準.midまたは.midiバイナリ[4]。 - ファイルサイズ:最大 256 KB[4]。
- ファイル数:1 リクエストにつき MIDI URL 1 件(
midi_urlsは最大 1 要素のみ受付)。また、参照添付ファイル(style、lyrics、image_urls、audio_urls、video_urls、midi_urls)の合計は 10 件を超えられません[4]。 - モード:インスピレーションモード(
custom_mode: false)のみ。midi_urlsと説明的なprompt(最大 3,000 文字)を組み合わせることができますが、他の非カスタム入力がある場合はpromptを省略できます[4]。 - 長さ:音楽タイムラインが 6 秒以上であること。2026 年 11 月 19 日の当社本番テストで検証済みです[4]。
楽曲生成用の動作する Suno MIDI API リクエスト
curl -X POST https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"custom_mode": false,
"instrumental": true,
"version": "V6_WILD",
"prompt": "Warm ambient electric piano and soft synth pad following the MIDI progression",
"midi_urls": ["https://your-storage.example.com/original-progression-12s.mid"]
}'このエンドポイントは即座にタスク ID を返します。status が "completed" または "failed" になるまで GET /api/v1/tasks/{id} をポーリングします[4]。完了した Suno MIDI 生成では、output.audio_urls[] に 2 つの音声バリエーションが返され、output.tracks[] にインデックスが対応した 2 件のメタデータエントリが返されます。各エントリには再利用可能な id、url、title、duration が含まれます[4]。
本番 MIDI アップロードテストで実際に失敗したケース
有効な .mid ファイルが弾かれる理由は、ドキュメントだけではほとんど分かりません。2026 年 11 月 19 日に本番の有料生成タスクに対して Suno MIDI インポートをエンドツーエンドでテストしたところ、現実的な 2 つの失敗ケースがすぐに現れました。
- 6 秒未満の短いスケッチは拒否されます。 最初のテストでは、120 BPM の四分音符 4 つ(合計 2 秒)を収めた有効な 58 バイトの Format 0 MIDI ファイルをアップロードしました。タスクは
"Your MIDI file is too short for us to check. Minimum duration is 6 seconds"で失敗し、仮押さえされたクレジットは返金されました(usage.credits: 0)。送信前に短いリフは 6 秒以上になるようパディングしてください。 - 教科書的な音階は既知の録音との照合に引っかかることがあります。 2 回目のテストでは、単純なハ長調の上行・下行音階でファイルを 10 秒に延長しました。ファイルは新規に合成した MIDI バイト列だったにもかかわらず、タスクは
"Our system matched this upload to a known recording"で失敗しました(こちらも 0 クレジットで返金)。r/SunoAI のプロデューサーからも、単音メロディや定番の練習フレーズで同様の誤検出が報告されています。 - オリジナルのポリフォニック進行は問題なく通ります。 音階を、100 BPM・12 秒・461 バイトのオリジナル D リディアンコードおよびメロディ進行に差し替えたところ、54.2 秒で完了し、再生可能な MP3 バリエーションが 2 つ返されました(reAPI CDN 上で
HTTP 200)。
Suno MIDI アップロードを中心に自動化パイプラインを構築する場合は、両方の失敗モードを早い段階で捕捉してください。API を呼ぶ前にクライアント側でローカルに MIDI の長さを確認し(6 秒未満はすべてブロック)、単純な音階や既知のカバーメロディはフィンガープリントによる拒否を引き起こす可能性があることをユーザーに警告してください。
楽曲とステムから Suno MIDI をエクスポートする
音声からノートへ戻す処理は、常に 2 段階の作業になります。Suno Studio も Suno MIDI API も、密度の高いステレオマスターを 1 ステップで直接 MIDI に文字起こしすることはありません。
Suno Studio 内では、まず Stems パネルでクリップを分割し、ボーカル、ドラム、ベース、その他のレイヤーを分離します。個別の Suno MIDI ステムができたら、対象ステムをクリックし、コンテキストメニューから Get MIDI を選びます。Studio は 10 Suno クレジットを消費し、そのまま DAW へドラッグできる標準 MIDI ファイルを出力します[2]。
reAPI の HTTP インターフェースを使う場合も、手順は Studio の設計に対応していますが、1 つ便利な利点があります。元のトラックを先に Suno で生成しておく必要がありません。
ステップ 1:suno-vocal-separation でステムを分離する
suno-vocal-separation は相互に排他的な 2 種類のソース指定形式に対応しています[4]。
- reAPI 上で生成済みの既存トラック:
task_id(完了した reAPI のtask_...ID)とaudio_id(output.tracks[]内の 1 エントリのid)を渡します。 - 自分でアップロードした音声:
audio_urlのみを渡します(公開 HTTP(S) URL、最大 20 MB、audio_id不要)。audio_urlとともにaudio_idを渡し続けるレガシー呼び出し元も、後方互換性のため引き続き受け付けられます[4]。
分離の type はコストと後段の Suno MIDI エクスポート精度の両方を左右するため、意図的に選択してください。
separate_vocal(デフォルト、$0.05/ 50 クレジット):2 つのステム(VocalsとInstrumental)に分割します[4][5]。split_stem_advanced($0.10/ 100 クレジット):stem_nameで特定の 1 楽器を分離します(Piano、Bass、Electric Guitar、Drum Kit、Lead Vocalなど 98 種類の対応楽器)[4][5]。split_stem($0.25/ 250 クレジット):一度に最大 12 ステムへ分割します[4][5]。
curl -X POST https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-vocal-separation",
"audio_url": "https://your-storage.example.com/mix.mp3",
"type": "separate_vocal"
}'GET /api/v1/tasks/{sep_task_id} が完了すると、output.tracks[] に分離された各ステムが、その label(Vocals や Instrumental など)および固有のトラック id とともに返されます[4]。
ステップ 2:suno-midi で分離済みステムを MIDI 変換する
次に、model: "suno-midi" を送信します。その際、task_id には元の suno-music タスク ID ではなく、ボーカル分離タスクの ID を設定してください[4]。通常の楽曲生成タスク ID を渡すと拒否されます。1 本のステムだけを変換するには分離タスクの output.tracks[].id から audio_id を含め、分離されたすべてのステムを変換するには audio_id を省略します[4]。
curl -X POST https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-midi",
"task_id": "task_YOUR_SEPARATION_TASK_ID",
"audio_id": "STEM_TRACK_ID_FROM_SEPARATION"
}'Studio の .mid ダウンロードとは異なり、Suno MIDI API は output.result.midi 内に構造化ノートデータを返します[4]。
{
"output": {
"result": {
"midi": {
"state": "completed",
"instruments": [
{
"name": "Electric Bass (finger)",
"notes": [
{ "pitch": 45, "start": 1.24, "end": 1.72, "velocity": 0.78 }
]
}
]
}
}
}
}各ノートエントリには、標準 MIDI の pitch(0–127)、秒単位の start と end、および正規化された velocity(0–1)が含まれます[4]。後段のツールが JSON ではなくバイナリの .mid ファイルを必要とする場合、Node.js で @tonejs/midi を使えば output.result.midi を数行で変換できます。
import { writeFileSync } from 'node:fs';
import { Midi } from '@tonejs/midi';
function saveSunoMidiJson(midiResult, outPath) {
const midi = new Midi();
for (const inst of midiResult.instruments ?? []) {
const track = midi.addTrack();
track.name = inst.name;
for (const n of inst.notes ?? []) {
track.addNote({
midi: n.pitch,
time: n.start,
duration: Math.max(0.02, n.end - n.start),
velocity: n.velocity,
});
}
}
writeFileSync(outPath, Buffer.from(midi.toArray()));
}Suno MIDI エクスポート品質に関する現実的な見通し
Suno MIDI エクスポートを MuseScore のような記譜ツールへ直接取り込もうとした r/SunoAI のプロデューサーからは、余計なゴーストノート、不安定なリズム、ポリフォニックのかぶり(ブリード)がよく報告されています。こうした指摘には 2 つの技術的背景があります。
- オーディオから MIDI への変換はステムのかぶりを引き継ぎます。 ステム内に残ったリバーブの残響や重なり合うコードレイヤーは、ピッチ検出時に余分な短いノートになります。
suno-midiを呼ぶ前に、1 つの明瞭な楽器(PianoやBassなど)に対してsplit_stem_advancedを実行するか、separate_vocalを使う方が、密度の高いフルミックスを変換するよりもきれいなノート配列になりやすいです。 - 12 ステムの
split_stemは空のノートデータを返すことがあります。 reAPI Suno リファレンスに記載のとおり、type: "split_stem"で作成した分離結果では、音数の少ないステムやノイズの多いステムでノートが一切検出されないことがあります[4]。変換後にノートデータがまったく残らない場合、reAPI は空の結果を返すのではなく、そのsuno-midiタスクを失敗として報告し、クレジットを返金します[4]。
抽出した Suno MIDI は、そのまま印刷できる楽譜ではなく、DAW 上で編集するための和声・リズムスケッチとして扱ってください。クオンタイズ(Studio の Shift+Q または DAW のグリッド)をかけ、50 ms 未満の低ベロシティなアーティファクトを取り除き、自分の仮想楽器を割り当ててください。
パイプライン全体の料金と文字数制限
reAPI は Suno リクエストを操作ごとの固定単価で課金しており、音声の長さやモデルバージョンによって変動しません(V6、V6_MINI、V6_WILD は同額です)。失敗または拒否されたタスクは自動的に返金されます。以下の料金は 2026 年 11 月 19 日に /models/suno で確認したものです。最新料金は公開中の Suno モデルページ または Suno V6 ページ で確認してください[5]。
| Suno MIDI パイプラインのステップ | reAPI model + オプション | 単価(USD、2026 年 11 月 19 日確認)[5] | クレジット(1 クレジット = $0.001)[5] |
|---|---|---|---|
| MIDI から楽曲生成(2 トラック) | suno-music(V6_WILD + midi_urls) | $0.06[5] | 60 |
| ボーカル + インスト分離 | suno-vocal-separation(separate_vocal) | $0.05[5] | 50 |
| 98 楽器から 1 楽器を分離 | suno-vocal-separation(split_stem_advanced) | $0.10[5] | 100 |
| 最大 12 ステムへ分離 | suno-vocal-separation(split_stem) | $0.25[5] | 250 |
| ステムから MIDI ノート JSON を抽出 | suno-midi | $0.001[5] | 1 |
上記の 2026 年 11 月 19 日時点の料金で計算すると、Suno MIDI の完全な往復処理(MIDI からトラック生成 $0.06、ボーカルとインスト分離 $0.05、MIDI JSON 変換 $0.001)は合計 $0.111(111 クレジット)になります[5]。手元の音声ファイルを持ち込み、split_stem_advanced($0.10)と suno-midi($0.001)だけで分離したピアノのノートを抽出する場合、この 2 コールのワークフローは合計 $0.101(101 クレジット)です[5]。
プロンプトを Suno MIDI リクエストと組み合わせる際、テキストのバリデーションエラーに当たる開発者も多いため、suno-music における正確な V6 文字数制限を以下にまとめます[4]。
prompt:インスピレーションモード(custom_mode: false、midi_urlsに必須)では最大 3,000 文字、V6 モデルのカスタムモード(custom_mode: true)では最大 5,000 文字。lyrics:最大 5,000 文字(歌唱される歌詞としてpromptより優先されます)。style:V6 モデルでは最大 1,000 文字(旧 V4 では 200 文字)。title:suno-musicでは最大 80 文字(V6 の extend および mashup 操作では 100 文字)。
よくある質問
Suno から MIDI をエクスポートするにはどうすればよいですか?
Suno Studio では、最初に Stems パネルからクリップをステムに分割し、次にステムを選んで Get MIDI(10 Suno クレジット)を選択すると標準 MIDI ファイルをダウンロードできます[2]。reAPI 上の Suno MIDI API を使う場合は、まず suno-vocal-separation を実行し、その完了した分離タスクの task_id を suno-midi に渡すことで、構造化された楽器とノートの JSON を取得できます[4]。
同じプロンプトに複数の MIDI ファイルをアップロードできますか?
いいえ。現在の suno-music の Suno MIDI 要件では、midi_urls が受け付ける .mid または .midi の URL は 1 リクエストにつき最大 1 件です[4]。アレンジでピアノ、ベース、ドラムが別々の DAW トラックに分かれている場合は、アップロード前に 1 つのマルチチャンネル標準 MIDI ファイル(最大 16 チャンネル、256 KB 未満)として書き出してください[1][4]。
有効な .mid ファイルが Suno に拒否されたのはなぜですか?
2026 年 11 月 19 日の当社本番テストでは、よくある 2 つの原因が確認されました。MIDI のタイムラインが 6 秒未満だった場合("Minimum duration is 6 seconds")、または単純な音階が既知の録音との照合を誘発した場合("Our system matched this upload to a known recording")です。あわせて、ファイルが標準の MThd バイナリヘッダーで始まっていること、256 KB 以下であること、そして data: URI ではなく公開 HTTP(S) URL から配信されていることも確認してください[4]。
Suno は MIDI 用の公式 API アクセスを提供していますか?
Suno は開発者向けの一般公開 REST API を公表していません。ネイティブの Suno MIDI 機能は、Pro および Premier 契約者向けの Suno Web アプリと Studio の内部に提供されています[1][3]。自動化パイプラインを構築する開発者は reAPI の Suno API のような統合 API ゲートウェイを利用しており、1 つの Bearer トークンと非同期ポーリング契約のもとで midi_urls、suno-vocal-separation、suno-midi を呼び出せます[4]。
MIDI を使うとき、Suno のプロンプトは何文字まで入力できますか?
suno-music で midi_urls を渡すとリクエストはインスピレーションモード(custom_mode: false)で実行され、prompt は最大 3,000 文字まで許容されます[4]。MIDI 添付なしのカスタムモードでは、V6 モデルで prompt と lyrics が最大 5,000 文字、style が最大 1,000 文字、title が最大 80 文字です[4]。
Suno MIDI は実際の DAW 音楽制作ワークフローで使えますか?
はい、各方向をそれぞれの強みに沿って使う限り実用になります。自分の DAW の MIDI ファイルから楽曲を始めれば、テキストプロンプトだけの場合よりも和声と構成をより密接に制御できます[1]。Suno の音声から MIDI を抽出する流れは、DAW プラグインで鳴らし直すためのコードボイシングやベースライン、メロディを拾う用途に向いています。ただし、先にステムをきれいに分離し、クオンタイズとゴーストノート除去に数分を見込むことが前提です。
Suno MIDI 作業で Studio と API のどちらを選ぶか
Chrome で USB キーボードを使って即興演奏し、ブラウザのタイムライン上でノートを編集し、ときどき手作業で WAV ステムや .mid ファイルを書き出すソロプロデューサーなら、Suno Studio を選んでください[2][3]。月額サブスクリプションなしで V6_WILD 上の midi_urls を実行したい場合、アップロードした音声を suno-vocal-separation と suno-midi でプログラム処理したい場合、またはノート配列を JSON のまま直接扱いたい場合は、reAPI の HTTP ワークフローを選んでください。いずれを選んでも、安定した Suno MIDI 結果を得るカギは 2 つの習慣に尽きます。入力側では 6 秒以上のオリジナルなマルチチャンネル .mid ファイルを書き出すこと、出力側では変換前にステムを丁寧に分離することです。
完全なパラメータースキーマは reAPI Suno API ドキュメント で確認でき、ブラウザ上から直接 Suno モデルページ で呼び出しをテストすることもできます。
参考文献
- Suno. Start Songs with MIDI. 2026 年 11 月 4 日公開。2026 年 11 月取得:suno.com/blog/MIDI-in-create
- Suno Help Center. Exporting from Studio. 2026 年 11 月取得:help.suno.com/en/articles/8128193
- Suno Help Center. MIDI in Studio. 2026 年 11 月取得:help.suno.com/en/articles/13670593
- reAPI. Suno API ドキュメント. 2026 年 11 月取得:reapi.ai/docs/suno
- reAPI. Suno モデルページおよび最新料金. 2026 年 11 月取得:reapi.ai/models/suno