Suno v5.5 API ガイド：AI 楽曲生成とボイス

テキストプロンプトを約 30〜90 秒で楽曲に変換し、そのファイルをシンプルな API フローでレビュー・保存・リリースへと進められます。

このガイドを一言でまとめると、次のようになります。

• キー、ヘッダー、ポーリングを使って API アクセスを設定する

• 適切なモードを選ぶ：説明（description）、カスタム歌詞（custom lyrics）、または インストゥルメンタルのみ（music-only）

• 短いプロンプト、ボイスの指示、クリップの延長で出力を整える

• ドラフトをステム、ミキシング、エクスポート、承認へと進める

• 結果リンクは 24〜72 時間 で失効する可能性があるため、ファイルを素早く保存する

• リリース前に商用権利、同意記録、承認ログを確認する

このガイドは主に、手作業でテストするだけでなく、楽曲生成を実際に稼働するコンテンツパイプラインの一部にしたい人向けです。アプリチーム、広告チーム、ポッドキャスト制作者、ゲームスタジオ、映像編集者などが対象です。

いくつかの数値が最初から重要になります。

• トラックは最長 240 秒 まで

• 最初のポーリングは約 5〜10 秒 待つ

• ポーリングは通常 5〜10 秒 ごとに継続する

• 429 のようなレート制限エラーには短いリトライ遅延が必要

• 承認ログの日付は 07/16/2026 のような米国形式で保存する

このセットアップで気に入っているのは、経路がシンプルなことです。リクエスト送信 → タスク ID 取得 → ステータスをポーリング → 音声をダウンロード → 保存 → 権利を確認。

ワークフローの短縮版はこちらです。

言い換えれば、これは「楽曲を作る」ことよりも、明確な入力・レビュー手順・ファイル処理を備えた 繰り返し使える音楽制作システムを構築する ことに重点があります。

実務プロジェクト向けに Suno v5.5 API アクセスを設定する

最初のリクエストは、資格情報、ヘッダー、非同期ポーリングの 3 つに集約されます。

API キー、認証、基本のリクエスト構造

アカウントを作成し、ダッシュボードのキー管理エリアで API キーを生成します。本番に移行する前に、クォータと IP ホワイトリストを設定しましょう。

キーをソースファイルにハードコーディングしないでください。 代わりに環境変数に入れます。

SUNO_API_KEY=your_key_here

ローカル作業では .env ファイルを使います。本番では GitHub Secrets や AWS Secrets Manager のようなシークレットマネージャーを使いましょう。すべてのリクエストで、次のヘッダーを送信します。

• Authorization: Bearer YOUR_API_KEY

• Content-Type: application/json

リクエストフローはとてもシンプルです。POST リクエストを送信し、タスク ID を保存し、5〜10 秒待ってから、ジョブが SUCCESS を返して音声 URL を返すまで 5〜10 秒ごとにポーリングします。^[2][7][3] ほとんどの場合、生成には 30〜90 秒かかります。^[2][3]

トラックの準備ができたらすぐにダウンロードするか、S3 バケットのような恒久的な保管場所へ移動します。一時的な結果 URL は長く利用できるとは限らないため、これが重要です。

JSON ペイロードの model フィールドには、"suno-v5.5" またはプロバイダーが記載する最新の同等の識別子を明示的に設定します。特定のモデルバージョンが必要な場合、デフォルトに頼らないでください。

APIMart をワークフロー層として使う

APIMart は Suno へのリクエストを 1 つのサーバーサイドワークフローを通して送信するため、資格情報をクライアントコードの外に保てます。平たく言えば、生のトークンはクライアントに残らず、すべての呼び出しが同じ統合層を通ります。

各リクエストで model パラメータを明示的に設定して、リクエストが Suno v5.5、または次のステップに必要なモデルへ向かうようにします。アクセスの設定ができたら、次はプロンプト設計と出力設定です。

適切なプロンプト、モード、出力設定で楽曲を生成する

アクセスの設定ができたら、プロンプトを書く 前に 生成モードと出力形式を選びます。Suno API のワークフローでは、custom_mode と instrumental が音声生成の前にあらかじめ決めておくべき主要フィールドです ^[5][8]。その後、ボイスやレビュー手順を整えて、ラフなドラフトを実際に使えるアセットに変えたり、AI 動画生成 のワークフローに統合したりできます。

説明モード vs. カスタム歌詞モード

説明モード（custom_mode: false）では、AI が短いテキストプロンプトから歌詞を書き、音楽スタイルを選びます。軽い指示で素早く出力したいときに最適です。カスタム歌詞モード（custom_mode: true）では、あなたが主導権を握ります。正確な歌詞、[Verse]、[Chorus]、[Bridge]、[Outro] のようなセクションタグ、そしてジャンル・ムード・テンポといったスタイルの詳細を指定します。これは、決まった構成を持つ広告、ブランドソング、クリエイタートラックに向いています ^[5][3]。

インストゥルメンタルのみの出力が欲しい場合は、instrumental: true を設定します。そして negative_tags を使って、"vocals, singing, voice" のような不要なボーカルをブロックします ^[6][5]。

広告、ブランド音楽、クリエイターコンテンツ向けのプロンプトパターン

ここではシンプルなプロンプトパターンがよく効きます：[genre] [mood] [instruments] [voice] [era/influence]。モデルがぶれないように、およそ 8〜12 個のキーワード に抑えるとよいでしょう ^[3]。混在したシグナルが多すぎると、モデルが迷ってしまいます。

モードは仕事に合わせるべきです。雰囲気を狙うときは説明モードを使います。楽曲がメッセージ、ブランドの一言、ストーリーを伝える必要があるときはカスタム歌詞モードを使います。また、"soft female vocals"、"deep male baritone"、"ethereal" のようなフレーズでボーカルの質感を直接指定して、サウンドをブランドトーンやチャンネルのスタイルに合わせ続けることもできます ^[3][5]。

制作利用のための出力計画

extend API を使って、クリップをつなぎ、よりまとまった 2〜4 分の楽曲にします。また、専用の [Outro] や明確な終端マーカーを入れておくと、トラックがきれいに締めくくれます ^[3]。

制作作業では、複数バージョンを生成し、それぞれをすぐにダウンロードし、ボーカルトラックと並べてインストゥルメンタルのカットも保存しておきましょう。そうすれば、ボーカルバージョンが広告・編集・最終レビューに合わないときのフォールバックになります。また、すべてのアセットをそのプロンプトとメタデータとともに、一貫した 1 つのプロジェクトフォルダに保存しておくと便利です。

次に、ボイスと編集ステップを磨き上げ、最良のバージョンをレビューに備えます。

ボイス、編集ステップ、商用ワークフローの制御を扱う

デフォルトボイス、クローンボイス、パーソナライズドボイスのワークフロー

Suno v5.5 は 3 つのボーカルワークフロー を提供しており、最初に正しいものを選ぶことで、後々のクリーンアップを大幅に減らせます。

デフォルトボイス は最速の経路です。プロンプトでボーカルスタイルを記述し（soft female vocals, ethereal や deep male baritone のように）、あとはモデルに任せます ^[3]。この選択肢は、1 つの固定されたボイスアイデンティティが必要ない、素早い商用ドラフトに向いています ^[5]。

クローンボイス はより多くの準備が必要ですが、安定して認識しやすいサウンドが得られます。クローンボイスは、ボイスの所有者から明確に文書化された同意を得ている場合にのみ使用してください ^[4]。

パーソナライズドボイスのワークフロー は、さらに一歩踏み込みます。これらは Suno v5.5 の編集フローと、Swap Vocals や Swap Sound のような機能を使い、複数回のパスにわたって最終アセットを微調整します ^[1][5]。

ボイスの経路を選んだら、次のステップはシンプルです。ドラフトを編集と承認へと進めます。

ドラフト楽曲から使えるアセットへ

最初の生成はドラフトです。完成したアセットではありません。

ワークフローは次のようになります。ドラフト → 延長 → ステム分割 → ミキシング → エクスポート。

まずは歌詞とボーカルのトーンをブリーフと照らし合わせて確認します。次にステムを分割して、ボーカルとインストゥルメンタルを別々のレイヤーに配置します。そうすることで、オーディオチームは FL Studio や Ableton のような DAW の中で作業する余地ができ、EQ、コンプレッション、リバーブを適用できます。その後、最終バージョンを WAV としてエクスポートし、BPM・ジャンル・スタイルタグなどのメタデータを付与してからプロジェクトフォルダに保存します。

承認済みの音声はすぐにダウンロードしましょう。

ライセンス、商用利用、社内承認チェック

リリース前に、権利をクリアし、すべての完成トラックについて承認を記録します。

まず、楽曲の生成に使ったアカウントが商用利用権を含んでいることを確認します。

次に、軽量な社内承認ステップを設けます。特定のアーティスト名や無許可の肖像に言及するプロンプトや歌詞セットにフラグを立てます。無許可の肖像やアーティスト名に紐づくリクエストは拒否される場合があります ^[5][6]。クローンボイスのアセットを扱っている場合は、同意記録を音声ファイルと一緒に保管しておきましょう。

監査追跡のために、確定した各アセットについて タスク ID、曲名、長さ、スタイルタグ、承認日を記録します。07/16/2026 のような米国の日付形式を使い、誰が承認したかも記録します ^[5][3]。

エンドツーエンドの APIMart 音楽パイプラインを構築する

チーム向けのシンプルな制作パイプライン

プロンプト、ボイス、ライセンスの選択が固まったら、それらを 1 つの繰り返し可能なフローにつなげます。ブリーフを入力し、承認済み音声を出力し、それを動画・広告・ソーシャル向けに保存します。

ブリーフを APIMart 経由で Suno に送信します。API はタスク ID を返し、n8n のようなオーケストレーション層が、ジョブが SUCCESS として返ってくるまでポーリングループを実行できます ^[2][5]。無駄に余分なリクエストを送らないよう、最初のポーリングの前に 10 秒待ちましょう。

目標はシンプルです。各受け渡しをツールや API にマッピングして、誰かが手作業でファイルやステータス更新を追いかけなくてもプロセスが回るようにすることです。

ここで 1 つ重要な点があります。生成された音声 URL は一時的で、24〜72 時間以内に失効する可能性があります ^[5]。そのため、パイプラインは承認済みファイルをすぐにダウンロードし、そのウィンドウが閉じる前に恒久的な保管場所へ移動すべきです。

基本フローが動いたら、却下された生成がプロンプト段階に戻るように、失敗時のルーティングを追加します。content_policy_violation の応答についても同様で、プロンプト変更のために戻して、キューが詰まらず動き続けるようにします ^[5]。

最初のステップ

繰り返し使える 1 つのワークフローから始め、それがエンドツーエンドで機能してから初めて広げていきましょう。まずは 1 つのユースケースを選びます。広告ジングル、ブランドの BGM、クリエイターのサウンドトラックなどです。

何かを公開する前に、あなたのプランに商用利用権が明確に含まれていることを確認します ^[1]。そして APIMart を、音楽生成をより大きな AI コンテンツワークフローに接続する層として使い、1 つの楽曲リクエストが、チームが何度も再利用できるシステムの中を流れるようにしましょう。

よくある質問（FAQ）

説明モード、カスタム歌詞モード、インストゥルメンタルモードはどう選べばいいですか？

どれだけコントロールしたいかで選びます。

• AI にテキストプロンプトから歌詞と作曲を作らせたいなら 説明モード を使います。

• 自分で歌詞や曲構成を用意したいなら カスタムモード を使います。

• BGM やジングルのようにボーカルなしのトラックが欲しいなら インストゥルメンタルモード を使います。

商用承認のために、生成した各トラックと一緒に何を保存すべきですか？

作成する各トラックについて、明確な記録を残しましょう。最低限、次を保存します。

• 一意のタスク ID

• 最終的に生成された音声ファイル

• 曲名、長さ、スタイルタグやプロンプトなどのメタデータ

• モデルバージョンと作成日

その記録があると、ライセンス遵守の確認や商用利用の監査証跡の維持がずっと簡単になります。

本番環境で一時的な音声リンクが失効しないようにするには？

Suno v5.5 API の音声リンクは一時的です。ほとんどの場合、24〜72 時間 以内に失効するため、長期的な制作アセットには向いていません。

より安全な手はこうです。ステータスポーリングでタスクが正常に完了したと表示されたら、すぐに 音声ファイルをダウンロード して、永続的な保管場所へ送ります。

たとえば次のような場所です。

• Google Drive

• ローカルファイルシステム

待ちすぎると、リンクが失効し、アプリが取得しようとしたときにはファイルが消えている可能性があります。