Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
还没有音频。提交表单以生成音频。
探索不同用例和参数配置
透明定价，无隐藏费用。按需支付。
| 规则与模式 | 渠道 | 积分 | 价格（美元） | 官方/参考价格 | 每日节省 |
|---|---|---|---|---|---|
Suno vocal-separation musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 使用完整指南
从 AI 生成的音乐中分离人声与伴奏——提取干净的人声轨道或器乐伴奏，用于混音和音乐制作。
Suno 人声分离 API 可将任何由 Suno 生成的歌曲分离为人声和器乐两个组成部分。借助先进的 AI 音频分离技术，该 API 能从混合音频中提取干净的人声轨道和纯器乐伴奏。你可以用它创建卡拉 OK 版本、使用不同人声进行混音、采样器乐元素，或分别分析和处理人声与音乐。
仅包含歌曲中人声元素的干净音频文件。非常适合混音、采样或制作清唱版本。
移除所有人声后的纯器乐版本。可用于卡拉 OK、背景音乐，或搭配不同人声进行混音。
先进的 AI 算法可实现干净分离，并将伪影降至最低。人声和器乐输出都能保持较高的音频质量。
可通过 task ID 和 audio ID 直接处理 suno/v5 生成的音轨。无需下载后再重新上传文件。
一次 API 调用即可同时获得分离的人声和器乐伴奏。两条轨道都与原始音频保持时间对齐。
分离后的轨道以高质量 MP3 格式交付，可立即用于 DAW、视频编辑器或进一步处理。
只需几个简单步骤，即可从器乐中分离人声
首先，使用 suno/v5 API 生成一首歌曲。记下响应中的 task ID。
查询任务以获取结果。每个任务会生成 2 个音频变体。选择你想要分离的 audio ID。
使用 task ID 和 audio ID 调用人声分离 API。其余流程由系统自动处理。
获取分离后的人声轨道和器乐伴奏。可用于混音、卡拉 OK 或音乐制作。
遵循这些建议，以获得理想的人声分离效果
在人声清晰的歌曲上，分离效果最佳。纯器乐音轨没有可提取的有效人声内容。
人声和乐器平衡良好的歌曲通常分离得最干净。经过重度处理或失真的音频可能会产生更多伪影。
在请求分离前，请确保源歌曲已完全生成。查询任务状态以确认成功。
从 AI 生成的歌曲中提取器乐伴奏，用于卡拉 OK 应用和跟唱体验。
分离人声以添加新的伴奏轨道，或使用器乐部分搭配不同的人声录音。
提取特定的人声片段或器乐元素，作为新作品中的采样使用。
分别分析人声和器乐组成部分，用于音乐教育、转录或 AI 训练。
与 suno/v5 生成流程无缝配合。在统一的 API 工作流中完成音乐生成和人声分离。
先进的分离 AI 可输出干净音轨，伪影更少，并保留完整的频率响应。
只需提供 task ID 和 audio ID，无需上传文件，也无需复杂参数。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
使用 SDK 创建任务，保存返回的 taskId，并获取 Suno 的结果。
运行这些 SDK 示例前，请先安装 @apipass-dev/apipass-sdk。
1npm install @apipass-dev/apipass-sdk
2# or
3pnpm add @apipass-dev/apipass-sdk
4# or
5yarn add @apipass-dev/apipass-sdk请将 API Key 保存在服务端环境变量中。SDK 会自动以 Bearer token 发送，并添加 JSON 请求头。
client.jobs.createTask创建一个新任务，用于从 Suno 生成的歌曲中分离人声和伴奏
通过这个示例快速上手所选语言的 SDK。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const task = await client.jobs.createTask({
8 "model": "suno/vocal-separation",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "taskId": "task_source_generate_xxx",
12 "audioId": "audio_xxx"
13 }
14});
15
16console.log(task.data.taskId);该 API 接收具有以下结构的 JSON 负载：
1{
2 "model": "suno/vocal-separation",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "taskId": "string (required)",
6 "audioId": "string (required)"
7 },
8 "channel": "auto"
9}model必填stringSuno 人声分离的模型标识符
"suno/vocal-separation"
callBackUrl可选string分离完成时用于接收 webhook 通知的 URL
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供商；这些提供商负责实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以在最低成本和可靠性能之间取得平衡。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
人声分离参数：
input.taskId必填string由已完成的 suno/generate 或 suno/extend createTask 调用返回的 ApiPass taskId。不要传入上游 NextMusic 提供商的任务 ID。
"task_abc123xyz"
input.audioId必填string已完成源任务结果项中的音频 ID。
"audio_001"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_vocal_separation_xxx"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询分离状态的任务 ID
人声分离完成后，将向你的 callBackUrl 发送 POST 请求
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_sep_xyz789",
5 "state": "success",
6 "completeTime": 1755599720000,
7 "costTime": 30000,
8 "model": "suno/vocal-separation",
9 "resultJson": {
10 "data": [
11 {
12 "id": "vocals_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_sep_xyz789_vocals.mp3",
14 "type": "vocals"
15 },
16 {
17 "id": "instrumental_001",
18 "audio_url": "https://cdn.apipass.dev/results/task_sep_xyz789_instrumental.mp3",
19 "type": "instrumental"
20 }
21 ]
22 }
23 },
24 "msg": "Vocal separation completed successfully."
25}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_sep_xyz789",
5 "state": "fail",
6 "failCode": "INVALID_SOURCE_TASK",
7 "failMsg": "Source task not found or has no provider_task_id"
8 },
9 "msg": "Vocal separation failed."
10}client.jobs.recordInfo查询分离任务状态并获取结果
通过这个示例快速上手所选语言的 SDK。
1import { Apipass } from "@apipass-dev/apipass-sdk";
2
3const client = new Apipass({
4 apiKey: process.env.APIPASS_API_KEY!,
5});
6
7const result = await client.jobs.recordInfo("task_sep_xyz789");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_sep_xyz789",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "vocals_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_sep_xyz789_vocals.mp3",
11 "type": "vocals"
12 },
13 {
14 "id": "instrumental_001",
15 "audio_url": "https://cdn.apipass.dev/results/task_sep_xyz789_instrumental.mp3",
16 "type": "instrumental"
17 }
18 ]
19 }
20 }
21}data.state当前状态：queuing、generating、success 或 fail
data.resultJson.data[0]分离出的人声音轨，type='vocals'
data.resultJson.data[1]伴奏音轨，type='instrumental'
API 页面显示参数架构，但 Suno 还有几个特定于业务的模式组合和回调规则，容易被忽略。
所有 API 都需要通过 Bearer Token 进行身份验证。
Authorization: Bearer
创建一个新任务，用于从 Suno 生成的歌曲中分离人声和伴奏
该 API 接收具有以下结构的 JSON 负载：
1{
2 "model": "suno/vocal-separation",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "taskId": "string (required)",
6 "audioId": "string (required)"
7 },
8 "channel": "auto"
9}model必填stringSuno 人声分离的模型标识符
"suno/vocal-separation"
callBackUrl可选string分离完成时用于接收 webhook 通知的 URL
"https://your-domain.com/api/callback"
channel可选string你可以通过 channel 参数指定 APIPASS 中对应的提供商；这些提供商负责实际的图像和视频生成任务。APIPASS 目前提供三种提供商选项：
channel 参数的默认值为 auto。启用后，APIPASS 会根据实时价格和稳定性指标，在可用提供商之间自动分配任务，以在最低成本和可靠性能之间取得平衡。除非你有自定义路由需求，否则请保留默认值 auto。
可用选项：
auto
人声分离参数：
input.taskId必填string由已完成的 suno/generate 或 suno/extend createTask 调用返回的 ApiPass taskId。不要传入上游 NextMusic 提供商的任务 ID。
"task_abc123xyz"
input.audioId必填string已完成源任务结果项中的音频 ID。
"audio_001"
1curl -X POST "https://api.apipass.dev/api/v1/jobs/createTask" \
2 -H "Content-Type: application/json" \
3 -H "Authorization: Bearer YOUR_API_KEY" \
4 -d '{
5 "model": "suno/vocal-separation",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "taskId": "task_source_generate_xxx",
9 "audioId": "audio_xxx"
10 }
11 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_vocal_separation_xxx"
6 }
7}code状态码，200 表示成功
message响应消息
data.taskId用于查询分离状态的任务 ID
