Skip to main content
GET
Suno V6 共通仕様とタスク照会
Suno の生成、編集、ツール API はすべて非同期タスクです。操作を送信して task_id を取得し、このページの API で結果を照会します。

認証

string
必須
Bearer Token 認証:Authorization: Bearer <YOUR_API_KEY>。
API Key 管理ページ にアクセスして API Key を取得してください.

V6 のバージョンとモデルの選択

公開モデルは次のバージョンに対応します。
  • v6
  • v6-wild
  • v6-mini
メイン生成 API では version またはモデル作成タスクが返した custom_model_id のどちらかが必要です。バージョン対応の編集操作では、version を省略すると v6 が使用されます。公開 version と custom_model_id は同時に送信できません。
custom: true はカスタム歌詞モードを選択し、custom_model_id はトレーニング済みカスタムモデルを選択します。両者は別の概念です。カスタム歌詞モードを使っても、自動的にカスタムモデル料金には切り替わりません。

V6 共通生成オプション

次のフィールドは、個別のエンドポイントに記載されている場合にのみ送信してください。 操作が対応していないフィールドは省略し、すべての操作に max_mode: false を送信しないでください。variety と Max モードは独立しているため、variety: "max" を選んでも Max 課金は有効になりません。

テキストと重みの制限

操作 API の新しいリクエストでは weirdness を使用し、weirdness_constraint は互換用の別名です。メイン生成では引き続き weirdness_constraint を使用します。文字数は Unicode 文字単位で計算されます。

参照元トラック

既存の作品を基にする操作:
  • task_id:出力音声トラックの API Mart タスク ID。
  • audio_index:参照元タスクの照会レスポンスにある data.result.music[] 内の元の位置です。1 始まりで、既定値は 1 です。
配列で返された件数をそのまま表示し、結果を 2 件に固定しないでください。画面上の表示順を変えても、後続操作では元の結果配列内のインデックスを使用する必要があります。
新しいリクエストでは参照元トラックを task_id + audio_index で指定します。audio_id、music_id、audio_url では代用できません。参照元タスクを解決できない場合やインデックスが範囲外の場合は 400 が返されます。

送信レスポンス

data[0].task_id からタスク ID を取得します。submitted はタスクが受理されたことだけを示し、最終的な音声などがすでに生成済みという意味ではありません。

タスクを照会

GET /v1/music/tasks/{task_id} ?language=zh を追加すると、対応する失敗メッセージの翻訳を取得できます。このパラメーターは曲や歌詞の言語を変更しません。
string
必須
送信 API が返すタスク ID。
最初に約 3 秒待ち、その後 data.status が completed または failed になるまで 5~10 秒ごとに照会することを推奨します。ページ更新後も同じタスク ID を使用できます。ネットワークタイムアウトを理由に有料 POST リクエストを自動再送しないでください。

照会レスポンス

integer
レスポンスステータスコード。
object
タスク情報。

結果の処理

  • 音楽関連の結果は通常 data.result.music[] にありますが、ダウンロード、歌詞、MIDI、Persona、カスタムモデルなどの操作では結果構造が異なります。
  • duration は実際の長さで、小数を含む場合があります。入力した目標時間と完成品の長さが完全に一致するとは限りません。
  • 重みの戻り値 0 は有効です。JavaScript の falsy 判定で非表示にしないでください。
  • audio_url の末尾が .mp3 であるとは限りません。API が返す実際の URL を使用して再生またはダウンロードしてください。
  • status="unknown" の場合はタスク ID を保持して手動更新を許可し、新しいタスクを自動作成しないでください。
AbortController はブラウザーリクエストとポーリングを停止できますが、サーバー側のタスクはキャンセルしません。現在、送信済み Suno タスクをキャンセルする API はありません。