メインコンテンツへスキップ
POST
ソース音源の参照:mashup はちょうど 2 つのソース音源が必要です——task_ids(自分の task_id をちょうど 2 つ入れた配列)で指定し、任意で audio_indexes(それと並行する配列で、各タスクの music[] の何番目を取るか、1 始まり、デフォルトはどちらも 1)を指定します。
custom がどのフィールドを有効にするかを決定します:誤ったモードで書かれたフィールドは上流によってエラーなく暗黙的に無視されます。custom=true のときは prompt(歌詞)、titletagsnegative_tagsauto_lyricsstyle_weightweirdness_constraintaudio_weightpersona_id が有効になり、gpt_description は無視されます;custom=false のときは gpt_description のみが読み取られます(この場合必須 — 無い場合、送信時に 400 を返します)。vocal_gender は両方のモードで有効です。custom を省略した場合、バックエンドは次の順序で推論します:prompt あり → trueprompt なしで gpt_description あり → false;それ以外は tags/title あり → true

Authorizations

Authorization
string
必須
すべてのエンドポイントは Bearer Token による認証が必要ですAPI Key の取得:API Key 管理ページ にアクセスして API Key を取得してください使用時にリクエストヘッダーに追加します:

Body

model
string
デフォルト:"suno"
音声モデル。現在は suno を渡します(指定しない場合はデフォルトで suno)。
task_ids
string[]
必須
2 つのソース音源が属するタスクの自分の task_id 配列(ちょうど 2 つ必要;数量が異なる場合は送信時に直接 400 を返します)。
audio_indexes
integer[]
task_ids と並行する配列。各タスクの結果 music[] の何番目を取るか(1 始まり、デフォルトはどちらも 1)。
instrumental
boolean
デフォルト:"false"
完全にインストゥルメンタルかどうか(true=ボーカルなし)。指定しない場合はデフォルトで false(ボーカルあり)。
version
string
デフォルト:"v5.5"
生成バージョン:v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5。音質と課金に影響します;指定しない場合はデフォルトで v5.5、不正な値は送信時に直接 400 を返します。
custom
boolean
true=カスタムモード(prompt を歌詞として使用);false=インスピレーションモード(gpt_description を使用);省略した場合は内容から推論されます(上記の Warning を参照)。
prompt
string
歌詞。custom=true のとき有効です(インスピレーションモードでは無視されます)。
gpt_description
string
インスピレーション用プロンプト。custom=false のとき必須 — 無い場合、リクエストは送信時に 400 で失敗します(上流は呼び出されず、課金もされません)。
title
string
タイトル。custom=true のときのみ有効
tags
string
スタイルタグ。custom=true のときのみ有効
negative_tags
string
除外するスタイルタグ。custom=true のときのみ有効
auto_lyrics
boolean
true=提供された歌詞を創作的に書き換えます。custom=true のときのみ有効
style_weight
number
スタイルの重み、0.001.00(範囲外の値は送信時に直接 400 を返します)。custom=true のときのみ有効
weirdness_constraint
number
創造性の重み、0.001.00(別名 weirdness)。custom=true のときのみ有効
audio_weight
number
オーディオの重み、0.001.00custom=true のときのみ有効
vocal_gender
string
ボーカルの性別:Male / Female両方のモードで有効
persona_id
string
Persona スタイル id。custom=true のときのみ有効
結果の取得:本エンドポイントは非同期タスクです。送信後に task_id を取得し、3〜5秒間隔で GET /v1/music/tasks/{task_id} をポーリングして、statuscompleted または failed になるまで待機します(音楽生成は通常30〜120秒;生成中は statuspending で、progress はキュー 10 → 準備完了 50 → 完了 100 と進みます)。完了後、data.result.music[] から audio_url を取得します。失敗した場合は data.error.message に理由が示され、事前に差し引かれた枠は自動的に返却されます。

Response

code
integer
レスポンスステータスコード
data
array
返却データ配列