Skip to main content
POST

Authorizations

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

Body

string
デフォルト:"suno"
音声モデル.現在は suno を渡します(指定しない場合はデフォルトで suno).
string
デフォルト:"v6"
公開バージョン:v6 / v6-wild / v6-mini。省略時の既定値は v6 です。
string
必須
効果音のテキスト説明.欠落している場合は送信時に直接 400 が返されます(課金されません).最良の結果を得るため、できるだけ英語のプロンプトを使用することをおすすめします.
string
デフォルト:"one-shot"
効果音のタイプ:one-shot(デフォルト、単発)/ loop(ループ可能).
integer
テンポ、1300;範囲外の値は送信時に直接 400 が返されます.
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)が返されます.
string
出力音声形式:mp3 / m4a / wav
この API はカスタムモデル、Max、variety、目標時間フィールドに対応していません。
結果の取得:この API は非同期タスクです。送信後に task_id を取得し、statuscompleted または failed になるまで 3~5 秒ごとに GET /v1/music/tasks/{task_id} をポーリングします(処理中の statuspending または processing で、progress は 0~100 の整数ですが一定間隔で変化するとは限りません)。完了後、data.result.music[] から audio_url を取得します。失敗時は data.error.message に理由が入り、差し引かれた金額は自動返金されます。

Response

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