人声和乐器分离

本页由 ModelFold 文档站根据上游官方 OpenAPI 文档同步生成。接口路径、参数、示例与官方保持一致；品牌与 API 域名已替换为 ModelFold。

接口

POST /jobs/createTask

完整 URL: https://ai.modelfold.online/v1/jobs/createTask

鉴权：所有请求都需要 Authorization: Bearer <API_KEY> 请求头。

文档已更新

若你此前已完成对接，仍可前往旧版文档查看：旧版地址 (https://ai.modelfold.online/docs/)

使用先进的音频处理技术将音乐分离为人声、伴奏和单个乐器轨道。

使用指南

将平台生成的混音分离为人声、伴奏及单乐器组件。
支持三种处理模式：
- separate_vocal — 2 轨分离（人声 + 伴奏）
- split_stem — 最多 12 轨分离
- split_stem_advanced — 高级多音轨分离，支持通过 stem_name 指定单个目标音轨
适用于卡拉 OK 制作、混音、采样提取或精细后期制作。
在具有清晰人声与乐器分层的专业 AI 混音上效果最佳。
计费说明： 每次调用消耗积分；对同一音轨重复调用会再次扣费（无服务端缓存）。
定价： 按次计费，单价随分离模式（type）变化。失败任务不扣费。当前价格见 ai.modelfold.online/pricing。

分离模式说明

模式（`type`）	返回音轨	典型用途
`separate_vocal` （默认）	2 轨 — 人声 + 伴奏	快速去人声、卡拉 OK、基础混音
`split_stem`	最多 12 轨 — 人声、和声、鼓、贝斯、吉他、键盘、弦乐、铜管、木管、打击乐、合成器、FX/其他；	进阶混音、重混、声音设计、单乐器提取
`split_stem_advanced`	返回 2 组，每组含 extract（仅目标音轨）与 remove（去除目标音轨后的其余部分）。	单乐器提取、精细后期

参数说明

名称	类型	说明
`task_id`	string	原始音乐生成任务的 ID
`audio_url`	string	用户上传音频文件的 URL 地址。使用用户上传音频时必填。不可与 audio_id 同时使用。
`audio_id`	string	存在多个版本时，指定要处理的音频变体。不可与 audio_url 同时使用。
`type`	string	分离模式：`separate_vocal` 、`split_stem`或 `split_stem_advanced`；默认 `separate_vocal`
`stem_name`	string	仅用于 type 为 split_stem_advanced，此时必填。

查询结果

轮询 GET /api/v1/jobs/recordInfo 时结果在 resultJson.resultUrls（文件名以轨道名结尾，如 _Vocals.mp3）。各轨 id（生成 MIDI 要用）只在回调的 vocal_removal_info.origin_data[].id 中返回。

开发者注意事项

所有返回的音频文件 URL 有效期为 14 天。
分离质量取决于原曲的复杂度和混音情况。
separate_vocal 返回 2 轨 — 人声 + 伴奏。
split_stem 返回 最多 12 条独立音轨 — 人声、和声、鼓、贝斯、吉他、键盘、弦乐、铜管、木管、打击乐、合成器、FX/其他。
split_stem_advanced 支持通过 stem_name 指定单个目标音轨进行精准提取。
计费： 每次请求都会扣费。重复提交同一音轨会 再次扣除积分（无服务端缓存）。

请求参数

请求体 (application/json)

参数	类型	必填	说明
`model`	`string`	是	模型名称示例：`ai-music-api/separate-vocals`。
`callBackUrl`	`string`	否	接收生成任务完成更新的 URL。可选但建议在生产环境中使用。 - 当生成完成时，系统将向此 URL POST 任务状态和结果 - 回调包含生成的 URL 和任务信息 - 您的回调端点应接受包含结果的 JSON 负载的 POST 请求 - 或者，使用获取任务详情端点轮询任务状态 - 为确保回调安全性，请参阅 Webhook 校验指南了解签名验证实现方法示例：`https://api.example.com/callback`。
`input`	`object	object`	是
`input.type`	`string`	否	分离类型，可选值： - separate_vocal: 分离人声和伴奏，生成人声轨道和伴奏轨道 - split_stem: 分离各种乐器声音，生成多个乐器轨道 - split_stem_advanced:高级多音轨分离，支持指定特定乐器音轨，生成更精细的乐器轨道默认值：`"separate_vocal"`。可选值：`separate_vocal` / `split_stem` / `split_stem_advanced`。示例：`separate_vocal`。
`input.stem_name`	`string`	否	仅在 type 为 split_stem_advanced 时使用，用于指定要分离的特定音轨/乐器名称可选值：`Lead Vocal` / `Drum Kit` / `Kick` / `Snare` / `Risers` / `Bass` / `Backing Vocals` / `Piano` / `Electric Guitar` / `Percussion` / `String Section` / `Synth` / `Acoustic Guitar` / `Sound Effects` / `Synth Pad` / `Synth Bass` / `Guitar` / `Brass Section` / `Organ` / `Electronic Drum Kit` / `Lead Electric Guitar` / `Synth Keys` / `Rhythm Electric Guitar` / `Electric Piano` / `Upright Bass` / `Keyboards` / `Distorted Electric Guitar` / `Synth Strings` / `Synth Lead` / `Woodwinds` / `Rhythm Acoustic Guitar` / `Flute` / `Harp` / `Tambourine` / `Trumpet` / `Arpeggiator` / `Accordion` / `Fiddle` / `Pedal Steel Guitar` / `Synth Voice` / `Violin` / `Digital Piano` / `Synth Brass` / `Mandolin` / `Choir` / `Banjo` / `Bells` / `Clarinet` / `Tenor Saxophone` / `Trombone` / `Shaker` / `French Horn` / `Glockenspiel` / `Electric Bass` / `Cello` / `Timpani` / `Harmonica` / `Marimba` / `Vibraphone` / `Lap Steel Guitar` / `Saxophone` / `Orchestra` / `Horns` / `Cymbals` / `Hand Clap` / `Oboe` / `Celesta` / `Congas` / `Drone` / `Alto Saxophone` / `Double Bass` / `Ukulele` / `Harpsichord` / `Baritone Saxophone` / `Xylophone` / `Tuba` / `Bass Guitar` / `Whistle` / `Lead Guitar` / `Rhodes` / `808` / `Bongos` / `Bassoon` / `Cowbell` / `Viola` / `Sitar` / `Steel Drums` / `Piccolo` / `Theremin` / `Bagpipes` / `Hi-Hat` / `Music Box` / `Melodica` / `Tabla` / `Koto` / `Djembe` / `Taiko` / `Didgeridoo`。示例：`Piano`。

请求示例

bash

curl -X POST "https://ai.modelfold.online/v1/jobs/createTask" \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "ai-music-api/separate-vocals",
  "callBackUrl": "https://api.example.com/callback",
  "input": {
    "task_id": "5c79****be8e",
    "audio_id": "e231****-****-****-****-****8cadc7dc",
    "type": "separate_vocal"
  }
}'

json

{
  "model": "ai-music-api/separate-vocals",
  "callBackUrl": "https://api.example.com/callback",
  "input": {
    "task_id": "5c79****be8e",
    "audio_id": "e231****-****-****-****-****8cadc7dc",
    "type": "separate_vocal"
  }
}

响应

200 — 请求成功

参数	类型	必填	说明
`code`	`integer`	否	请求状态码。请求失败时 HTTP 状态仍为 200，请始终以本字段判断：200 表示成功，其他值均表示失败，原因见 msg。常见值：401 API key 无效或缺失；402 积分不足；429 超出频率限制；422 或 500 请求未能处理（请先查看 msg、检查参数，再决定是否重试）。可选值：`200` / `401` / `402` / `404` / `409` / `422` / `429` / `451` / `455` / `500`。示例：`200`。
`msg`	`string`	否	当 code != 200 时的错误信息示例：`success`。
`data`	`object`	否	—
`data.taskId`	`string`	否	任务ID，用于后续查询任务状态示例：`5c79****be8e`。

json

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

回调

vocalRemovalGenerated

回调地址：{$request.body#/callBackUrl}（即请求体里的 callBackUrl）。

当人声分离生成完成时，系统会调用此回调通知结果。回调数据结构根据请求时的type参数而有所不同。

separate_vocal类型回调示例

json

{
  "code": 200,
  "msg": "vocal Removal generated successfully.",
  "data": {
    "task_id": "3e63b4cc88d52611159371f6af5571e7",
    "vocal_removal_info": {
      "instrumental_url": "https://file.aiquickdraw.com/s/d92a13bf-c6f4-4ade-bb47-f69738435528_Instrumental.mp3",
      "origin_url": "",
      "vocal_url": "https://file.aiquickdraw.com/s/3d7021c9-fa8b-4eda-91d1-3b9297ddb172_Vocals.mp3"
    }
  }
}

split_stem类型回调示例

json

{
  "code": 200,
  "msg": "vocal Removal generated successfully.",
  "data": {
    "task_id": "e649edb7abfd759285bd41a47a634b10",
    "vocal_removal_info": {
      "origin_url": "",
      "backing_vocals_url": "https://file.aiquickdraw.com/s/aadc51a3-4c88-4c8e-a4c8-e867c539673d_Backing_Vocals.mp3",
      "bass_url": "https://file.aiquickdraw.com/s/a3c2da5a-b364-4422-adb5-2692b9c26d33_Bass.mp3",
      "brass_url": "https://file.aiquickdraw.com/s/334b2d23-0c65-4a04-92c7-22f828afdd44_Brass.mp3",
      "drums_url": "https://file.aiquickdraw.com/s/ac75c5ea-ac77-4ad2-b7d9-66e140b78e44_Drums.mp3",
      "fx_url": "https://file.aiquickdraw.com/s/a8822c73-6629-4089-8f2a-d19f41f0007d_FX.mp3",
      "guitar_url": "https://file.aiquickdraw.com/s/064dd08e-d5d2-4201-9058-c5c40fb695b4_Guitar.mp3",
      "keyboard_url": "https://file.aiquickdraw.com/s/adc934e0-df7d-45da-8220-1dba160d74e0_Keyboard.mp3",
      "percussion_url": "https://file.aiquickdraw.com/s/0f70884d-047c-41f1-a6d0-7044618b7dc6_Percussion.mp3",
      "strings_url": "https://file.aiquickdraw.com/s/49829425-a5b0-424e-857a-75d4c63a426b_Strings.mp3",
      "synth_url": "https://file.aiquickdraw.com/s/56b2d94a-eb92-4d21-bc43-3460de0c8348_Synth.mp3",
      "vocal_url": "https://file.aiquickdraw.com/s/07420749-29a2-4054-9b62-e6a6f8b90ccb_Vocals.mp3",
      "woodwinds_url": "https://file.aiquickdraw.com/s/d81545b1-6f94-4388-9785-1aaa6ecabb02_Woodwinds.mp3"
    }
  }
}

回调体参数

参数	类型	必填	说明
`code`	`integer`	否	状态码示例：`200`。
`msg`	`string`	否	返回消息示例：`vocal Removal generated successfully.`。
`data`	`object`	否	—
`data.task_id`	`string`	否	任务ID
`data.vocal_removal_info`	`object`	否	人声分离结果信息，字段根据请求时的type参数而有所不同
`data.vocal_removal_info.origin_url`	`string`	否	原始音频URL
`data.vocal_removal_info.vocal_url`	`string`	否	人声部分音频URL
`data.vocal_removal_info.instrumental_url`	`string`	否	伴奏部分音频URL（仅separate_vocal类型）
`data.vocal_removal_info.backing_vocals_url`	`string`	否	背景人声音频URL（仅split_stem类型）
`data.vocal_removal_info.drums_url`	`string`	否	鼓声部分音频URL（仅split_stem类型）
`data.vocal_removal_info.bass_url`	`string`	否	贝斯部分音频URL（仅split_stem类型）
`data.vocal_removal_info.guitar_url`	`string`	否	吉他部分音频URL（仅split_stem类型）
`data.vocal_removal_info.keyboard_url`	`string`	否	键盘部分音频URL（仅split_stem类型）
`data.vocal_removal_info.percussion_url`	`string`	否	打击乐部分音频URL（仅split_stem类型）
`data.vocal_removal_info.strings_url`	`string`	否	弦乐部分音频URL（仅split_stem类型）
`data.vocal_removal_info.synth_url`	`string`	否	合成器部分音频URL（仅split_stem类型）
`data.vocal_removal_info.fx_url`	`string`	否	效果器部分音频URL（仅split_stem类型）
`data.vocal_removal_info.brass_url`	`string`	否	铜管部分音频URL（仅split_stem类型）
`data.vocal_removal_info.woodwinds_url`	`string`	否	木管部分音频URL（仅split_stem类型）

json

{
  "code": 200,
  "msg": "vocal Removal generated successfully.",
  "data": {
    "task_id": "",
    "vocal_removal_info": {
      "origin_url": "https://your-domain.com/input.png",
      "vocal_url": "https://your-domain.com/input.png",
      "instrumental_url": "https://your-domain.com/input.png",
      "backing_vocals_url": "https://your-domain.com/input.png",
      "drums_url": "https://your-domain.com/input.png",
      "bass_url": "https://your-domain.com/input.png",
      "guitar_url": "https://your-domain.com/input.png",
      "keyboard_url": "https://your-domain.com/input.png",
      "percussion_url": "https://your-domain.com/input.png",
      "strings_url": "https://your-domain.com/input.png",
      "synth_url": "https://your-domain.com/input.png",
      "fx_url": "https://your-domain.com/input.png",
      "brass_url": "https://your-domain.com/input.png",
      "woodwinds_url": "https://your-domain.com/input.png"
    }
  }
}

人声和乐器分离 ​

接口 ​

使用指南 ​

分离模式说明 ​

参数说明 ​

查询结果 ​

开发者注意事项 ​

请求参数 ​

请求体 (application/json) ​

请求示例 ​

响应 ​

200 — 请求成功 ​

回调 ​

vocalRemovalGenerated ​

separate_vocal类型回调示例 ​

split_stem类型回调示例 ​

人声和乐器分离

接口

使用指南

分离模式说明

参数说明

查询结果

开发者注意事项

请求参数

请求体 (application/json)

请求示例

响应

200 — 请求成功

回调

vocalRemovalGenerated

separate_vocal类型回调示例

split_stem类型回调示例