场景十一：stems 声曲分离 Vocals/Instrumental

做什么：把一首已生成的歌曲拆成两条音轨——人声（Vocals）与纯伴奏（Instrumental）。

A. 先准备一首歌

先用场景一 / 二 / 三生成音乐，拿到其中一首歌的 clip_id，例如：

text

a624123d-22cc-4d4d-bf28-78d312f61597

B. 提交声曲分离任务

text

POST https://api.allyang.cn/suno/generate

请求体（关键字段：mv=chirp-auk、task=gen_stem、stem_task=two、stem_type_group_name=Two，continue_clip_id 填 A 步的 clip_id）：

text

{
  "task": "gen_stem",
  "generation_type": "TEXT",
  "title": "安全之弦",
  "mv": "chirp-auk",
  "prompt": "",
  "make_instrumental": true,
  "continue_clip_id": "4720ad51-6d31-417c-a3a7-346b0b99abbc",
  "continued_aligned_prompt": null,
  "continue_at": null,
  "stem_type_id": 91,
  "stem_type_group_name": "Two",
  "stem_task": "two"
}

说明：

支持跨账号使用同一 clip_id 做分离；
计费按一次生成计（具体单价待核，见文末）。

返回体给出两个新 id（一条 - Vocals、一条 - Instrumental），后续查结果用这两个 id：

text

{
  "clips": [
    {
      "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
      "title": "<原曲名> - Vocals",
      "status": "queued",
      "metadata": {
        "type": "stem",
        "stem_from_id": "<A 步的 clip_id>",
        "tags": "Chinese",
        "duration": 217.24
      }
    },
    {
      "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
      "title": "<原曲名> - Instrumental",
      "status": "queued",
      "metadata": {
        "type": "stem",
        "stem_from_id": "<A 步的 clip_id>",
        "duration": 217.24
      }
    }
  ]
}

说明：为控制篇幅并避免搬运示例歌词，上例已省略 prompt 原文与播放统计等非关键字段；字段名与层级与接口返回保持一致。

C. 取回分离结果

text

GET https://api.allyang.cn/suno/feed/5f3587e2-75fb-4c36-84b3-3ec113897a4c,9c85d619-4cac-4561-8fa3-604c116fa1c5

返回数组，每条含 audio_url（mp3）与 video_url，status 为 complete 即完成：

text

[
  {
    "id": "5f3587e2-75fb-4c36-84b3-3ec113897a4c",
    "title": "<原曲名> - Vocals",
    "status": "complete",
    "audio_url": "<平台返回的音频地址>",
    "video_url": "<平台返回的视频地址>",
    "metadata": { "type": "stem", "duration": 217.24, "tags": "Chinese" }
  },
  {
    "id": "9c85d619-4cac-4561-8fa3-604c116fa1c5",
    "title": "<原曲名> - Instrumental",
    "status": "complete",
    "audio_url": "<平台返回的音频地址>",
    "video_url": "<平台返回的视频地址>",
    "metadata": { "type": "stem", "duration": 217.24, "tags": "Chinese" }
  }
]

待核项

计费口径：源文档仅写「一次生成费用」，具体单价待补；
stem_type_id / stem_type_group_name 的取值范围来源未说明；
返回地址的有效期未给出，拿到后请尽快转存。