跳转到主要内容
POST
提交分轨拆分任务
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询音乐详情接口获取结果。

使用指南

人声分离方式:
  • 此接口将音乐曲目拆分为多条乐器分轨
  • 为和声、贝斯、铜管、鼓、效果音、吉他、键盘、打击乐、弦乐、合成器、人声、木管和钢琴分别生成独立音轨
  • 适用于精细混音或单独提取特定乐器

参数详情

  • task_id(必填):已完成音乐生成任务(Generate Music 或 Extend Music)的任务 ID
  • audio_id(必填):回调数据中具体音轨的标识符

使用说明

  • 每条音轨只能执行一次分轨拆分
  • 回调会包含每条分轨的下载 URL

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key:

进入 仪表盘 → API 密钥(API Key 管理页面)获取你的 API Key

在请求头中添加:

请求体

application/json
model
string
必填
示例:

"stem-split"

callback_url
string<uri>
必填

用于结果通知的 Webhook 回调 URL。

该地址会收到 POST 请求,包含分轨拆分完成状态和各音轨的下载 URL。

示例:

"https://your-domain.com/callback"

input
object
必填

分轨拆分的输入参数

响应

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填