メインコンテンツへスキップ
POST
ソース音源の参照:既存の曲を対象とした操作では上流の id を記録する必要はなく、task_id(ソース音源を生成したタスクの当方の task_id)+ audio_index(結果の music[] 内の何曲目か、1 始まり、デフォルトは 1)を渡すだけです。
本エンドポイントにはバージョンの概念がありませんversion は渡さないでください。渡しても破棄され、課金には影響しません。

Authorizations

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

Body

model
string
デフォルト:"suno"
音声モデル。現在は suno を渡します(指定しない場合はデフォルトで suno)。
task_id
string
必須
ソース音源を生成したタスクの当方の task_id。指定が無い、またはソースを解決できない場合は、送信時に 400 を返します。
audio_index
integer
デフォルト:"1"
参照するソースタスク結果の data.music[] 内の何曲目か(1 始まり;デフォルトは 1;1回の生成で通常2曲:インデックス 1 と 2)。
name
string
必須
Persona 名称。指定しない場合は上流に送信されず、即座に 400 を返します。
describe
string
説明。
styles
string
スタイル。
vox_audio_id
string
「Vox 抽出」で得られる id。
vocal_start_s
integer
ボーカルクリップの開始(秒)。vox_audio_id を参照する場合は、その Vox を抽出した際に使用したクリップ範囲と一致する必要があります。
vocal_end_s
integer
ボーカルクリップの終了(秒)。vox_audio_id を参照する場合は、その Vox を抽出した際に使用したクリップ範囲と一致する必要があります。
結果の取得:本エンドポイントは非同期タスクです。送信後に task_id を取得し、3〜5秒間隔で GET /v1/music/tasks/{task_id} をポーリングして、statuscompleted または failed になるまで待機します(通常30〜120秒。生成中は statuspending で、progress はキュー投入 10 → 準備完了 50 → 完了 100 と進みます)。結果に persona 情報が含まれます。失敗した場合は data.error.message に理由が示され、事前に差し引かれた枠は自動的に返却されます。

Response

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