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

Authorizations

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

Body

model
string
デフォルト:"suno"
音声モデル。現在は suno を渡します(指定しない場合はデフォルトで suno)。
audio_urls
array
必須
1〜4個の公開アクセス可能な音声 URL の配列。
version
string
デフォルト:"v5.5"
生成バージョン:v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5。音質と課金に影響します;指定しない場合はデフォルトで v5.5 になります。
prompt
string
歌詞 / 内容。
title
string
タイトル。
tags
string
スタイルタグ。
negative_tags
string
除外するスタイルタグ。
style_weight
number
スタイルの重み、0.001.00
weirdness_constraint
number
創造度の重み、0.001.00(別名 weirdness)。
audio_weight
number
音声の重み、0.001.00
vocal_gender
string
ボーカルの性別:Male / Female
auto_lyrics
boolean
true=入力された歌詞をもとに二次創作します。
結果の取得:本エンドポイントは非同期タスクです。送信後に task_id を取得し、3〜5秒間隔で GET /v1/music/tasks/{task_id} をポーリングして、statuscompleted または failed になるまで待機します(音楽生成は通常30〜120秒;生成中は statuspending で、progress はキュー登録 10 → 準備完了 50 → 完了 100 と進みます)。完了したら data.result.music[] から audio_url を取得します。失敗した場合は data.error.message に原因が示され、事前に差し引かれた枠が自動的に返却されます。

Response

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