Skip to main content
POST
参照元音声:既存曲を基にする操作では追加 ID は不要です。元トラックを生成したタスクの task_id と、data.result.music[] 内の結果トラックを指定する audio_index(1 始まり、既定値 1)を渡してください。
本エンドポイントにはバージョンの概念がありません.version は渡さないでください.渡しても破棄され、課金には影響しません.

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)。
string
必須
Persona 名称.指定しない場合は即座に 400 を返します.
string
説明.
string
スタイル.
number
音声クリップの開始位置(秒)。0 以上にしてください。vocal_end_s と併せて指定することを推奨します。
number
音声クリップの終了位置(秒)。開始位置より大きく、既知の参照元時間を超えない値にしてください。
完了後に result.persona_id を取得します。Persona ID はカスタムモデル ID とは異なり、model の API 値には使用できません。新しいフローでは事前に Vox を作成する必要はありません。
結果の取得:これは非同期タスクです。送信後に task_id を取得し、statuscompleted または failed になるまで 3~5 秒ごとに GET /v1/music/tasks/{task_id} をポーリングします(通常 30~120 秒かかります。処理中の statuspending または processing で、progress は 0~100 の整数ですが一定間隔で変化するとは限りません)。完了後の結果には Persona 情報が含まれます。失敗時は data.error.message に理由が入り、差し引かれた金額は自動返金されます。

Response

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