人声伴奏分离

将音频中的人声与伴奏分离，输出独立的人声音轨与伴奏音轨。支持 fast（快速）与 turbo（增强）两种分离模式。

创建任务

基本信息

项目	值
请求方法	POST
请求路径	/task/audio_separation
Content-Type	application/json
鉴权方式	Authorization 请求头（直接传 API Key）

请求参数（Body）

参数名	类型	必填	默认值	说明
file_id	string	是	—	已上传音频文件的 ID
mode	string	否	fast	分离模式。fast：快速模式；turbo：增强模式（更高分离质量）
need_vocals	boolean	否	true	是否输出人声音轨
need_instrumental	boolean	否	true	是否输出伴奏音轨

need_vocals 与 need_instrumental 不可同时为 false。

请求示例

curl -X POST https://api.ai-mcn.tv:10000/task/audio_separation \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_id": "537489015178246",
    "mode": "fast",
    "need_vocals": true,
    "need_instrumental": true
  }'

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "task_type": "audio_separation",
    "status": "queued"
  }
}

---

查询任务结果

基本信息

项目	值
请求方法	GET
请求路径	/task/audio_separation/{task_id}
鉴权方式	Authorization 请求头（直接传 API Key）

响应参数（output_result）

参数名	类型	说明
files	array	分离后的音轨文件列表
files[].type	string	音轨类型：vocals（人声）/ instrumental（伴奏）
files[].file_id	string	输出文件 ID
files[].download_url	string	音频下载路径

成功响应示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "task_id": "537489015178247",
    "status": "completed",
    "progress": 100,
    "output_result": {
      "files": [
        {
          "type": "vocals",
          "file_id": "537489015178248",
          "download_url": "/download/a1/537489015178248.wav"
        },
        {
          "type": "instrumental",
          "file_id": "537489015178249",
          "download_url": "/download/a1/537489015178249.wav"
        }
      ]
    },
    "create_time": "2026-05-29T08:00:00Z",
    "update_time": "2026-05-29T08:00:40Z"
  }
}

使用限制

• 输入仅支持音频文件（mp3、wav、m4a、aac、flac、ogg 等）。
• 按音频时长（分钟）计费。
• fast 与 turbo 输出格式均为 wav。

错误码

错误码	HTTP 状态码	说明	解决方案
6013	400	file_id 缺失	传入 file_id 参数
6014	400	文件类型不支持	上传受支持的音频文件
6016	400	业务参数非法（如 mode 取值错误、人声与伴奏同时关闭）	检查 mode / need_vocals / need_instrumental
6017	400	媒体探测失败	确认文件未损坏且为有效音频
6004	404	文件不存在	检查 file_id 是否正确
6502	401	鉴权失败	检查 Authorization 请求头
6202	402	余额不足	前往仪表盘充值