メインコンテンツへスキップ
POST

Authorizations

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

Body

model
string
デフォルト:"suno"
音声モデル。現在は suno を渡します(指定しない場合はデフォルトで suno)。
version
string
デフォルト:"v5.5"
生成バージョン:v5 / v5.5 のみ;指定しない場合はデフォルトで v5.5 になります。
prompt
string
必須
効果音のテキスト説明(上流の sound にマッピングされます)。欠落している場合は送信時に直接 400 が返されます(上流を呼び出さず、課金もされません)。
type
string
デフォルト:"one-shot"
効果音のタイプ:one-shot(デフォルト、単発)/ loop(ループ可能)。
bpm
integer
テンポ、1300;範囲外の値は送信時に直接 400 が返されます。
key
string
調性の列挙値:長調は C / C# / D / D# / E / F / F# / G / G# / A / A# / B;短調は末尾に m を付けます(Cm / C#m / … / Bm)。シャープ(#)表記のみサポートされます;フラット(Db / Eb など)と B#400(key param error)が返されます。
結果の取得:本エンドポイントは非同期タスクです。送信後に task_id を取得し、3〜5秒間隔で GET /v1/music/tasks/{task_id} をポーリングして、statuscompleted または failed になるまで待機します(生成中は statuspending で、progress はキュー登録 10 → 準備完了 50 → 完了 100 と進みます)。完了したら data.result.music[] から audio_url を取得します。失敗した場合は data.error.message に原因が示され、事前に差し引かれた枠が自動的に返却されます。

Response

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