Skip to main content
POST
ソース音源の参照:mashup はちょうど 2 つのソース音源が必要です——task_ids(自分の task_id をちょうど 2 つ入れた配列)で指定し、任意で audio_indexes(それと並行する配列で、各タスクの music[] の何番目を取るか、1 始まり、デフォルトはどちらも 1)を指定します.
custom は有効になるフィールドを決定します。選択中のモードで使用されないフィールドであっても、送信する値は型・範囲・長さの要件を満たす必要があります。custom=true では prompt を歌詞として使用し、instrumental=false の場合は下記の条件に従って必須になることがあります。custom=false では gpt_description が必須です。custom を省略すると、バックエンドは prompt、gpt_description、tags、title からモードを推定します。

Authorizations

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

Body

string
デフォルト:"suno"
音声モデル.現在は suno を渡します(指定しない場合はデフォルトで suno).
string[]
必須
2 つのソース音源が属するタスクの自分の task_id 配列(ちょうど 2 つ必要;数量が異なる場合は送信時に直接 400 を返します).
integer[]
task_ids と並行する配列で、各タスクの data.result.music[] からトラックを選択します(1 始まり、各要素の既定値は 1)。
boolean
デフォルト:"false"
完全にインストゥルメンタルかどうか(true=ボーカルなし).指定しない場合はデフォルトで false(ボーカルあり).
string
デフォルト:"v6"
公開バージョン:v6 / v6-wild / v6-mini。既定値は v6 です。custom_model_id を使用する場合は省略してください。
string
モデル作成タスクが返す完全な UUID。version および persona_id と同時に指定できません。
boolean
true=カスタムモード(prompt を歌詞として使用);false=インスピレーションモード(gpt_description を使用);省略した場合は内容から推論されます(上記の Warning を参照).
string
条件付き必須:custom=true && instrumental=false の場合は歌詞を指定してください。インスピレーションモードでは使用されませんが、送信する値は長さの上限を満たす必要があります。
string
インスピレーション用プロンプト.custom=false のとき必須 — 無い場合、リクエストは送信時に 400 で失敗します(課金もされません).
string
タイトル.custom=true のときのみ有効.
string
スタイルタグ.custom=true のときのみ有効.
string
除外するスタイルタグ.custom=true のときのみ有効.
boolean
true=提供された歌詞を創作的に書き換えます.custom=true のときのみ有効.
number
スタイルの重み、0.00–1.00(範囲外の値は送信時に直接 400 を返します).custom=true のときのみ有効.
number
創造性の重み。0.00~1.00。weirdness_constraint は互換用の別名です。新しいリクエストでは weirdness を使用してください。
number
オーディオの重み、0.00–1.00.custom=true のときのみ有効.
string
ボーカルの性別:Male / Female.両方のモードで有効.
string
Persona スタイル ID。custom=true の場合のみ有効で、custom_model_id と同時に指定できません。
string
スタイルの変化:off / normal / high / extra / max。任意です。
boolean
デフォルト:"false"
Max モードを有効にします。カスタムモードが必要で、料金は通常価格の 2 倍です。
string
出力音声形式:mp3 / m4a / wav。このエンドポイントは目標時間フィールドに対応していません。
結果の取得:これは非同期タスクです。送信後に task_id を取得し、status が completed または failed になるまで 3~5 秒ごとに GET /v1/music/tasks/{task_id} をポーリングします(音楽生成は通常 30~120 秒かかります。処理中の status は pending または processing で、progress は 0~100 の整数ですが一定間隔で変化するとは限りません)。完了後、data.result.music[] から audio_url を取得します。失敗時は data.error.message に理由が入り、差し引かれた金額は自動返金されます。

Response

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