Skip to main content
POST
このエンドポイントは公開音声 URL から直接カバーを作成するため、事前に uploadTask を呼び出す必要はありません。task_id が返されるので、GET /v1/music/tasks/{task_id} をポーリングして結果を取得してください。

Authorizations

string
必須
Bearer Token。API Key 管理ページ で API Key を取得してください。

Body

string
デフォルト:"suno"
常に suno を指定します。
string
必須
公開アクセス可能な音声ファイルの直接 HTTP(S) URL。参照元音声は 8 分未満にしてください。ローカルパス、blob: URL、ログインが必要なリンクは使用できません。
string
デフォルト:"v6"
公開バージョン:v6 / v6-wild / v6-mini。既定値は v6 です。custom_model_id を使用する場合は省略してください。
string
モデル作成タスクが返す完全な UUID。version および persona_id と同時に指定できません。
boolean
このフィールドは明示的に送信してください。false では gpt_descriptiontrue では歌詞とスタイルのフィールドを使用します。
boolean
デフォルト:"false"
インストゥルメンタル音声を生成するかどうか。custom=true かつこのフィールドが false の場合、prompt は必須です。
string
インスピレーションの説明。custom=false の場合は必須で、最大 3,000 文字です。
string
カスタム歌詞。最大 5,000 文字。
string
スタイルの説明。最大 1,000 文字。
string
タイトル。最大 80 文字。
string
除外するスタイル。
number
スタイルの重み。0~1。
number
創造性の重み。0~1。
number
音声の重み。0~1。
boolean
入力した歌詞を創造的に書き換えるかどうか。
string
ボーカルの性別:Male / Female
string
Persona ID。custom_model_id と同時に指定できません。
integer
目標生成時間。10~360 秒。カスタムモードでのみ使用できます。
string
スタイルの変化:off / normal / high / extra / max
boolean
デフォルト:"false"
Max モードを有効にします。カスタムモードが必要で、料金は通常価格の 2 倍です。
string
出力形式:mp3 / m4a / wav

Response

integer
レスポンスステータスコード。
array
送信結果。data[0].task_id を取得し、タスク照会 API をポーリングしてください。