音楽生成タスクを作成する

音楽生成の送信インターフェース。旧 /suno/submit/music パスと互換性があります。タスク ID を返し、後続は /suno/fetch/{task_id} で照会します。

音楽生成タスクの送信インターフェース。パスは /suno/submit/music のままで、実際には upstream_model、music_model、engine、model_id、または modelId で生成エンジンを選択できます。作成インターフェースは task_id を返し、その後 /suno/fetch/{task_id} で出力を照会します。

プロンプト記述モード

スタイル、感情、言語、歌手タイプ、シーンのみを記述する場合に適しており、モデルが自動的に楽曲内容を生成します。

{
 "model": "suno_music",
 "upstream_model": "suno-v5",
 "prompt": "Imitating "Billie Jean," create a DJ song with the theme of "the artificial intelligence revolution."",
 "make_instrumental": false
}

インストゥルメンタルまたは純伴奏

light_music=true または make_instrumental=true を使用できます。light_music はインストゥルメンタル／BGM 寄りであることを示し、make_instrumental は歌唱ボーカルを生成しないことを示します。

{
 "model": "suno_music",
 "upstream_model": "minimax-music-v2.6",
 "prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.",
 "light_music": true,
 "make_instrumental": true
}

歌詞の詳細モード

業務側ですでに歌詞が用意されており、タイトルとスタイルタグを指定する必要がある場合に適しています。custom_mode=true を指定でき、歌詞フィールドには lyrics、lyric、custom_lyrics、または customLyrics を使用できます。

{
 "model": "suno_music",
 "upstream_model": "mureka-v9",
 "custom_mode": true,
 "title": "Summer Sea Breeze",
 "tags": "electro pop, female vocal, bright summer",
 "lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light"
}

照会

作成成功後、返却された data のタスク ID を保存します。たとえば task_xxx です。GET /suno/fetch/{task_id} を呼び出して、状態、音声 URL、カバー、タイトル、歌詞、および上流から返された元のセグメント情報を照会します。