分轨提取

从已有歌曲中提取指定类型的分轨。
本模型无版本维度，不要传 version；即使传入也会被 MAPI 丢弃，不影响计费。
stem_type 省略时默认提取 lead_vocal（主人声）。
官方支持 100 多种分轨类型，常用值包括 lead_vocal、backing_vocals、drum_kit、bass、piano、electric_guitar。
任务完成后，结果中包含分离出的音轨 URL；建议每 3–5 秒查询一次公共任务接口。
提交接口：统一通过 POST /v1/music/generations 提交，使用 model: "suno-stems" 选择此能力。
任务查询：提交返回 task_id，通过 GET /v1/music/generations/{task_id} 获取任务状态和结果。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 MAPI Bearer Token 认证。格式：Authorization: Bearer sk-xxxxxx。

In: header

Request Body

application/json

model*string

固定填写 suno-stems。

task_id*string

产出源音轨的任务 ID，必填。

audio_index?integer

源任务音轨序号，1-based，默认 1。

Default1

Range1 <= value

stem_type?string

要提取的分轨类型，省略默认 lead_vocal。常用值包括 lead_vocal、backing_vocals、drum_kit、bass、piano、electric_guitar。808 必须作为字符串发送。

Default"lead_vocal"

audio_format?string

输出音频格式。

Value in"mp3" | "m4a" | "wav"

Response Body

application/json

curl -X POST "https://loading/v1/music/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-stems",
    "task_id": "task_source123",
    "audio_index": 1,
    "stem_type": "lead_vocal"
  }'

curl -X POST "https://loading/v1/music/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "suno-stems",    "task_id": "task_source123",    "audio_index": 1,    "stem_type": "lead_vocal"  }'

{
  "code": 200,
  "message": "success",
  "data": [
    {
      "status": "submitted",
      "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw"
    }
  ]
}

{
  "code": "invalid_request",
  "message": "task_id is required",
  "data": null
}

Authorization

Request Body

Response Body

200application/json

400application/json

application/json

application/json