Skip to main content
AIを使用して音楽と歌詞を生成します。これは非同期 API です。作成レスポンスはタスク ID を返し、利用可能な場合は優先して使う poll_url も返します。

リクエストボディ

string
デフォルト:"suno_music"
使用するモデル:音楽生成には suno_music、歌詞のみには suno_lyrics を使用します。
string
音楽の説明。music、lyrics、upload-cover、upload-extend では必須です。add-instrumental では省略できます。
string
生成された曲のタイトル。
string
スタイルタグ(例:「pop, upbeat, electronic」)。
string
避けたいスタイル。audio_operationadd-instrumental の場合は必須です。
string
生成タイプ:MUSIC(デフォルト)または LYRICS
string
公式のSunoモデルバージョン。音楽生成では必須です(actionを省略した場合、またはMUSICの場合)。歌詞のみのリクエストでは省略します。対応値: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
boolean
true にするとボーカルなしのインストゥルメンタルを生成します。
string
公開アクセス可能な参照またはアップロード済み音声 URL。audio_operation を省略すると upload-cover フローを使います。
string
アップロード音声モード:upload-coverupload-extendadd-instrumentalupload-extend には continue_atadd-instrumental には audio_urltitletagsnegative_tags が必要です。
string
続きから開始する前のクリップのID。
number
継続を開始する秒数。audio_operationupload-extend の場合は必須です。

レスポンス

string
ステータスをポーリングするためのタスクID。
string
アダプタが返す場合の非同期タスク ID 別名です。
string
利用可能な場合に返される優先ポーリング URL です。
string
タスクのステータス:pendingprocessingcompleted、または failed
integer
タスク作成時のUnixタイムスタンプ。