Suno 音乐生成

请求地址

POST /v1/audio/generations

兼容地址：

POST /media/audio/generations

查询和取消：

GET /v1/audio/generations/{id}
POST /v1/audio/generations/{id}/cancel

/media/audio/generations/{id} 和 /media/audio/generations/{id}/cancel 保持兼容。

生成音乐

{
  "model": "suno-music",
  "mode": "v5_5",
  "generation_type": "music_generation",
  "client_request_id": "suno-demo-001",
  "custom_mode": false,
  "prompt": "uplifting synth pop with bright drums and a confident chorus"
}

自定义纯音乐：

{
  "model": "suno-music",
  "mode": "v5_5",
  "generation_type": "music_generation",
  "client_request_id": "suno-instrumental-001",
  "custom_mode": true,
  "instrumental": true,
  "style": "cinematic ambient pop, warm analog synths",
  "title": "Soft Horizon"
}

规则：

• mode 当前只支持 v5_5。
• custom_mode=false 时必须传 prompt，最多 500 字符。
• custom_mode=true 时必须传 style 和 title。
• custom_mode=true 且 instrumental=false 时还必须传 prompt。
• 自定义 prompt 最多 5000 字符，style 最多 1000 字符，生成 title 最多 80 字符。
• 不支持 duration_seconds、persona_id、persona_model、原始 audio_id、原始 task_id 或自定义 callback URL。

创建成功返回 202 Accepted：

{
  "code": 0,
  "message": "accepted",
  "data": {
    "id": "task_xxx",
    "status": "queued"
  }
}

扩展音乐

扩展音乐时，source_generation_id 使用本平台返回的 task_xxx，不要传上游原始任务 ID。

{
  "model": "suno-music",
  "mode": "v5_5",
  "generation_type": "music_extend",
  "client_request_id": "suno-extend-001",
  "source_generation_id": "task_xxx",
  "source_track_index": 0,
  "default_param_flag": false
}

自定义扩展：

{
  "model": "suno-music",
  "mode": "v5_5",
  "generation_type": "music_extend",
  "client_request_id": "suno-extend-custom-001",
  "source_generation_id": "task_xxx",
  "source_track_index": 0,
  "default_param_flag": true,
  "continue_at_seconds": 42.5,
  "prompt": "continue with a bigger second chorus and tighter drums",
  "style": "cinematic synth pop",
  "title": "Soft Horizon Extended"
}

查询结果

{
  "code": 0,
  "message": "success",
  "data": {
    "id": "task_xxx",
    "kind": "audio",
    "status": "completed",
    "model": "suno-music",
    "mode": "v5_5",
    "family": "suno",
    "generation_type": "music_generation",
    "poll_url": "/v1/audio/generations/task_xxx",
    "cancel_url": "/v1/audio/generations/task_xxx/cancel",
    "result": {
      "outputs": ["https://static.example.com/media/suno-output.mp3"],
      "tracks": [
        {
          "index": 0,
          "title": "Soft Horizon",
          "duration_seconds": 123.4,
          "cover_url": "https://example.com/cover.jpg"
        }
      ]
    }
  }
}

说明：

• result.outputs 是可直接播放或下载的音频 URL。
• result.tracks 包含每条音轨的标题、封面、时长、歌词/提示词等结果信息，具体字段按上游结果返回。