音楽または音声生成タスクを作成する

音楽および音声生成の送信 API。旧 /suno/submit/music パスと互換性があります。タスク ID を返し、後続は /suno/fetch/{task_id} で確認します。

音楽および音声生成タスクの送信 API。パスは /suno/submit/music のままで、実際の生成エンジンは upstream_model、music_model、engine、model_id、または modelId で選択できます。作成 API は task_id を返し、その後 /suno/fetch/{task_id} で出力を確認します。

upstream_model を指定しない場合（または {"model":"suno_music"} のみを指定した場合）、既定で Suno v5.5 を使用します。旧版 Suno を引き続き使用する場合は、"upstream_model":"suno-v5" を明示的に指定してください。

新規追加モデル

プロンプト記述モード

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

{
  "model": "suno_music",
  "upstream_model": "suno-v5.5",
  "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
  "make_instrumental": false
}

音声生成

MiniMax Speech は extraParams（またはトップレベルの同名 snake_case/camelCase フィールド）を介して音声パラメーターをオーバーライドできます。

{
  "model": "suno_music",
  "upstream_model": "minimax-speech-2.8-hd",
  "prompt": "欢迎使用新版语音生成服务。",
  "extraParams": {
    "voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85",
    "outputFormat": "mp3",
    "sampleRate": 32000,
    "speed": 1,
    "volume": 1,
    "pitch": 0
  }
}

MiniMax Speech で音声パラメータが未指定の場合、サーバーは既定で上記の voice、outputFormat=mp3、sampleRate=32000、speed=1、volume=1、pitch=0 を送信します。

Lyria 3 Pro は upstream_model=lyria-3-pro（または lyria-3-pro-preview）を使用します：

{
  "model": "suno_music",
  "upstream_model": "lyria-3-pro",
  "prompt": "Cinematic orchestral music with a hopeful finale."
}

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

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、カバー、タイトル、歌詞、および上流から返された元のセグメント情報を照会します。