Skip to main content
POST
参照元音声:既存曲を基にする操作では追加 ID は不要です。元トラックを生成したタスクの task_id と、data.result.music[] 内の結果トラックを指定する audio_index(1 始まり、既定値 1)を渡してください。
extendcustom は任意で、既定値は true です。custom=true では prompt に延長部分の歌詞を指定します。custom=false を明示した場合のみ、gpt_description が延長方向を決定します。

Authorizations

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

Body

string
デフォルト:"suno"
音声モデル.現在は suno を渡します(指定しない場合はデフォルトで suno).
string
必須
ソース音源を生成したタスクの task_id.欠落している場合やソースを解決できない場合は、送信時に直接 400 が返されます.
integer
デフォルト:"1"
参照元タスクの data.result.music[] からトラックを選択します(1 始まり、既定値 1)。
number
必須
延長を開始する秒数。1 以上で、参照元トラックの実際の長さ未満にしてください。小数秒に対応します。
string
デフォルト:"v6"
公開バージョン:v6 / v6-wild / v6-mini。既定値は v6 です。custom_model_id を使用する場合は省略してください。
string
モデル作成タスクが返す完全な UUID。version および persona_id と同時に指定できません。
boolean
デフォルト:"true"
trueprompt の歌詞で延長、false=インスピレーションによる延長。省略時は true です。
string
延長部分の歌詞.custom=true のとき有効です.
string
インスピレーションの説明。custom=false を明示した場合のみ有効で、延長方向の指定に使用します。
string
タイトル.custom=true の場合のみ有効です.
string
スタイルタグ.custom=true の場合のみ有効です.
string
除外するスタイルタグ.custom=true の場合のみ有効です.
string
ボーカルの性別:Male / Female.両方のモードで有効です.
number
スタイルの重み、0.001.00(範囲外の値は送信時に直接 400 が返されます).custom=true の場合のみ有効です.
number
創造性の重み。0.001.00。旧名 weirdness_constraint にも対応しますが、新しいリクエストでは weirdness を使用してください。
number
音声の重み、0.001.00.custom=true の場合のみ有効です.
boolean
true=入力された歌詞をもとに二次創作します.custom=true の場合のみ有効です.
string
Persona スタイル ID。custom=true の場合のみ有効で、custom_model_id と同時に指定できません。
integer
目標生成時間は 10~360 秒です。custom=true の場合のみ使用でき、実際の長さは結果に基づきます。
string
スタイルの変化:off / normal / high / extra / max。任意です。
boolean
デフォルト:"false"
Max モードを有効にするかどうか。有効化には custom=true が必要で、料金は通常価格の 2 倍です。
string
出力音声形式:mp3 / m4a / wav
結果:これは非同期タスクです。送信後に task_id を取得し、statuscompleted または failed になるまで 3~5 秒ごとに GET /v1/music/tasks/{task_id} をポーリングします(音楽生成は通常 30~120 秒かかります。処理中の statuspending または processing で、progress は 0~100 の整数ですが一定間隔で変化するとは限りません)。完了後、data.result.music[] から延長後トラックの audio_url を取得します。失敗時は data.error.message に理由が入り、差し引かれた金額は自動返金されます。

Response

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