メインコンテンツへスキップ
POST
ソース音源の参照:本エンドポイントは task_id + audio_index使いません。公開アクセス可能な audio_url を直接渡す必要があります(アップストリームがそこから音色を抽出します)。無い場合は 400 audio_url cannot be empty を返します。
本エンドポイントにはバージョンの概念がありませんversion は渡さないでください。渡しても破棄され、課金には影響しません。

Authorizations

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

Body

model
string
デフォルト:"suno"
音声モデル。現在は suno を渡します(指定しない場合はデフォルトで suno)。
audio_url
string
必須
ソース音源の公開アクセス可能な URL。アップストリームがそこから音色を抽出します。**MP3 / WAV のみ受け付けます。**無い場合は 400 audio_url cannot be empty を返します。
結果の取得:本エンドポイントは非同期タスクです。送信後に task_id を取得し、3〜5秒間隔で GET /v1/music/tasks/{task_id} をポーリングして、statuscompleted または failed になるまで待機します(通常30〜120秒。生成中は statuspending で、progress はキュー投入 10 → 準備完了 50 → 完了 100 と進みます)。結果に作成された音色情報が含まれます。失敗した場合は data.error.message に理由が示され、事前に差し引かれた枠は自動的に返却されます。

Response

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