2026/09/14

Suno V6 API：既存実装のバージョン選択と移行ガイド

Suno V6 API の V6・Mini・Wild の選び方、旧バージョンと snake_case への移行、非同期タスク、音声結果と呼び出し料金を解説します。

reAPI の Suno V6 API は既存の音声エンドポイントを使い、version: "V6"、"V6_MINI"、"V6_WILD" でバージョンを指定します。古い実装では、バージョンとフィールド名の両方を確認してください。現在の Suno インターフェースは snake_case を使います。旧バージョンの値は検証を通っても、生成時に失敗することがあります。^[1]

最初は model: "suno-music" に V6 の値を明示します。非同期の送信とポーリングはそのまま使い、後の編集に備えてトラック識別子を保存してください。まずリクエストの組み立てを更新し、次に完了結果の読み取り方を確認します。モデル名を suno-v6 に変える方法は、文書化された V6 の選択方法ではありません。

要点

version に V6、V6_MINI、V6_WILD のいずれかを指定し、楽曲生成のモデル ID は suno-music のままにします。^[1]
旧 camelCase フィールドを custom_mode、negative_tags、audio_id などの snake_case に変更します。^[1]
廃止された V4–V5.5 の値は送信しないでください。スキーマに通ることと、音声を生成できることは別です。^[1]
明確な制作指示には V6、待ち時間の短縮を検討するなら Mini、探索には Wild が出発点になります。これは Suno の説明に基づく選び方で、実測による性能保証ではありません。^[2]
完了した楽曲生成は、2 テイクを含めて 1 リクエスト $0.06。音響効果は別料金の 13 credits です。^[3]

Suno V6 API のリクエストで変わる点

Suno は 2026 年 9 月 9 日に V6 を発表し、3 つの派生モデルと、旧世代からの移行方針を示しました。^[2] 開発者がまず区別すべきなのは、製品発表の機能と、実際に送信できる API フィールドです。

発表には幅広い制作・編集機能が含まれますが、そのすべてが reAPI の音声リクエストで利用できるわけではありません。現在の楽曲生成では、テキスト制御や関連する音声処理が文書化されています。一般向け機能の発表に画像や動画が登場しても、その入力フィールドを独自に追加しないでください。Suno の完全なパラメータリファレンスに従って実装します。^[1]

Suno V6 リファレンスには現在のリクエスト形式があります。model が操作を、version がその操作で使う音楽モデルを選びます。両者をアプリで分けて扱えば、Mini を選んだときに生成から編集へ誤って切り替わることを防げます。^[4]

ここで説明するのは reAPI のサービスです。Suno 自身の公開開発者フォームは、選定したパートナーとの探索段階を説明しており、本番用キーをセルフサービスで発行するものではありません。^[5]

V6、Suno V6 Mini、Suno V6 Wild の選び方

次の生成結果に何を求めるかで選びます。Suno は主力モデルを精度重視、Wild を予測しにくい探索向け、Mini を高速で効率的な制作向けと説明しています。以下は、その説明を実務上の判断に落としたものです。^[2]

API の値	出発点となる用途	自分のジョブで評価する点
`V6`	ジャンル、編曲、歌詞の方向が明確	音楽上の指示に十分沿っているか
`V6_MINI`	待ち時間が重要な反復作業	全体の待ち時間と、どちらかのテイクが品質基準を満たすか
`V6_WILD`	編曲を決める前の探索	変化が役立つか、それとも編集負担を増やすか

Mini は安価な API プランではありません。同じ操作なら 3 種の V6 で同額です。結果が速く返っても、減るのは待ち時間であり、そのリクエストの表示料金ではありません。^[4] 本記事では、条件を統制した遅延測定や試聴比較は行っていません。自分の処理で測るまでは、「速い」は Suno の製品上の位置づけとして扱ってください。

比較時はプロンプト、モード、他の制御を固定し、version だけを変えます。返ってきた両方のテイクを評価してください。同時に歌詞やスタイルも変更すると、どの変更が差を生んだのか分からなくなります。

各ジョブに選択バージョンを記録します。延長処理は元トラックと同じバージョンを要求するため、新曲用の選択設定で後続の延長リクエストを勝手に上書きしないでください。^[1]

Suno V6 と V5.5：バージョンとフィールド名を一緒に移行する

既存実装での Suno V6 と V5.5 の違いは、まずリクエストが完了できるかです。reAPI は V4、V4_5、V4_5PLUS、V4_5ALL、V5、V5_5 を廃止済みと記載しています。スキーマは値を保持していますが、生成は失敗し、返金されます。^[1]

失敗する場所は 2 つあります。未対応フィールドは送信時に拒否されます。一方、受け付けられた旧バージョンは、タスクが作られた後で失敗する場合があります。POST の HTTP ステータスだけでは後者を見逃します。

画面の選択欄だけでなく、保存済みプリセットやサーバーの既定値も確認してください。画面に「V6」と表示されていても、バックグラウンドワーカーが古いペイロードを送り続けている可能性があります。

旧リクエストの一部	現在の書き方
`"version": "V5_5"`	新曲生成では `"version": "V6"`
`"customMode": false`	`"custom_mode": false`
`"negativeTags": "metal"`	`"negative_tags": "metal"`
`"audioId": "…"`	トラック参照操作では `"audio_id": "…"`

完全版リファレンスは、2026 年 9 月 13 日のフィールド名変更を記録しています。^[1] リクエストオブジェクトを個別に更新してください。保存済み結果や無関係な連携まで一括置換すると、移行対象外の内容を変更する恐れがあります。

新規ジョブでは、有効な V6 の元トラックを生成してから、それに依存する編集を試します。V6 を選ぶだけで、すべての旧トラック ID があらゆる操作に対応するとは考えないでください。

V6 ページが扱う 8 つの操作

V6 専用ページには 8 操作があります。いずれも POST /api/v1/audio/generations を使いますが、必須入力は異なります。^[4]

操作	`model`	`version` の規則
楽曲生成	`suno-music`	必須
生成済みトラックの延長	`suno-extend`	必須。元のバージョンに合わせる
アップロード音声のカバー	`suno-upload-cover`	必須
アップロード音声の延長	`suno-upload-extend`	必須。元のバージョン規則に従う
ボーカル追加	`suno-add-vocals`	任意。既定値は `V6`
伴奏追加	`suno-add-instrumental`	任意。既定値は `V6`
アップロード音声のマッシュアップ	`suno-mashup`	必須
音響効果生成	`suno-sounds`	必須

全体には 18 の非同期操作があります。残り 10 操作は V6 ページの対象外ですが、すべてがバージョンを拒否するわけではありません。suno-replace-section は既存の task_id と audio_id、または upload_url と version の組を受け付けます。アップロード分岐はバージョン必須、既存トラック分岐は省略必須です。両分岐を混ぜると無効になります。^[1]

全 Suno リクエストに version を共通付与しているなら、その前提を外してください。必要な操作だけに付けます。WAV 変換、歌詞生成、音声関連操作にも、それぞれ独自の入出力仕様があります。

最初の V6 リクエストを送り、音声を待つ

reAPI キー、選択した操作を支払えるクレジット、サーバー側で認証情報を保持する場所が必要です。最初はインスピレーションモードならペイロードが小さくなります。prompt で曲を説明し、歌詞はモデルが作ります。^[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

戻り値のタスクの id を読み、タスク取得エンドポイントに渡します。以下の TASK_ID は実際の値に置き換えるプレースホルダーです。

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

送信成功は音声完成を意味しません。待機中・処理中はポーリングし、失敗なら停止し、status が completed になったら出力を使います。ポーリングにクレジットはかかりません。^[4]

本記事の準備中、本番 playground で V6 の生成を 1 回実行しました。完了応答には output.audio_urls と output.tracks がそれぞれ 2 件ありました。確認できたのはこの例の出力数であり、性能や信頼性のベンチマークではありません。

output.tracks[].id が返れば、親タスク ID とともに保存します。audio_id に音声 URL を代入してはいけません。文書上保証されるのはトラック URL で、空のメタデータは省略される場合があります。後続操作を有効にする前に、歌詞・長さ・ID の欠落を処理してください。^[4]

歌詞を指定する場合はカスタムモードにし、style と title も渡します。Suno V6 のバージョンパラメータは custom_mode の意味を変えません。長さの指定はカスタムモードで有効になり、整数の目標値は 10–360 秒です。^[4]

V6 呼び出しの料金

9 月 14 日に確認した Suno V6 料金表では、完了した楽曲生成は 1 リクエスト $0.06、60 credits です。2 テイクを含みます。2 で割ると返却トラックあたり $0.03 ですが、これは計算上の換算で、個別購入できる単曲料金ではありません。^[3]

1 テイクしか採用しなければ、その使える曲の費用は $0.06 です。再生成や後続処理は別途課金されます。Mini を選んだり、対応範囲内で短い曲を指定したりしても、その呼び出しは値下がりしません。^[4]

音響効果は別です。元の表示単価は $0.0125、整数クレジットの引き落としは 13 credits、$0.013 相当です。予算では元の単価を切り下げず、請求クレジットを使ってください。^[3]

認証情報の設定は Suno API Key ガイド、他の操作の料金は完全な料金表を参照してください。公式の開発者アクセスについては公式 API の提供状況で別途説明しています。

reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.