メインコンテンツへスキップ
POST
custom はどのフィールドが有効になるかを決定します:モードと一致しないフィールドは上流で黙って無視されます(エラーになりません)。custom=true(カスタム)の場合、prompt(歌詞)、titlestylenegative_tagsauto_lyricspersona_idstyle_weightweirdness_constraintaudio_weight が有効です;custom=false(インスピレーション)の場合、prompt はインスピレーションの説明として使用され、title/style と上記のカスタムフィールドは無視されます。vocal_gender は両方のモードで有効です。
本エンドポイントは独立したルートを使用するため、一部のフィールド名が他のエンドポイントと異なります:styletags ではない)。

Authorizations

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

Body

model
string
デフォルト:"suno"
音声モデル。現在は suno を渡します(指定しない場合はデフォルトで suno)。
custom
boolean
デフォルト:"false"
false=インスピレーションモード;true=カスタムモード(prompt を歌詞として使用)。デフォルトは false
instrumental
boolean
デフォルト:"false"
true=インストゥルメンタルのみ、ボーカルなし。デフォルトは false
version
string
必須
生成バージョン:v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5。音質と課金に影響します。両方のモードで必須;指定しない場合は直接 400 が返されます
prompt
string
インスピレーションプロンプト / 歌詞。custom=false の場合は必須(インスピレーションの説明として使用)。custom=true の場合:instrumental=false なら必須(歌詞として使用);instrumental=true なら省略可能。欠落している場合は送信時に直接 400 が返されます(上流を呼び出さず、課金もされません)。
title
string
タイトル(カスタムモード)。custom=false(インスピレーションモード)の場合は無視されます
style
string
スタイルタグ(カスタムモード、上流の tags に対応)。custom=false(インスピレーションモード)の場合は無視されます
negative_tags
string
負のスタイルタグ(避けたいスタイル)。custom=true の場合のみ有効です
auto_lyrics
boolean
true=入力された歌詞をもとに二次創作します。custom=true の場合のみ有効です
persona_id
string
Persona スタイル id。custom=true の場合のみ有効です
vocal_gender
string
ボーカルの性別:Male / Femalem / f / male / female も受け付けられ、バックエンドで自動的に正規化されます)。両方のモードで有効です
style_weight
number
スタイルの重み、0.001.00custom=true の場合のみ有効です
weirdness_constraint
number
創造度、0.001.00custom=true の場合のみ有効です
audio_weight
number
音声の重み、0.001.00custom=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 を取得します(ほかに image_url / video_url / title / duration などもあります)。失敗した場合は data.error.message に原因が示され、事前に差し引かれた枠が自動的に返却されます。

Response

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