Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 오디오가 없습니다. 폼을 제출해 오디오를 생성하세요.
다양한 사용 사례와 매개변수 구성을 살펴보세요
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
Suno vocal-separation musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 사용 전체 가이드
AI로 생성된 음악에서 보컬과 반주를 분리하세요. 리믹스와 프로덕션을 위해 깨끗한 보컬 트랙 또는 인스트루멘털 반주를 추출할 수 있습니다.
Suno 보컬 분리 API를 사용하면 Suno로 생성된 모든 곡을 보컬과 인스트루멘털 구성 요소로 분리할 수 있습니다. 고급 AI 오디오 분리 기술을 활용해 혼합 오디오에서 깨끗한 보컬 트랙과 순수한 인스트루멘털 반주를 추출합니다. 이를 통해 노래방 버전을 만들거나, 다른 보컬로 리믹스하거나, 인스트루멘털 요소를 샘플링하거나, 보컬과 음악을 독립적으로 분석하고 처리할 수 있습니다.
곡에서 보컬 요소만 포함한 깨끗한 오디오 파일입니다. 리믹스, 샘플링 또는 아카펠라 버전 제작에 적합합니다.
모든 보컬이 제거된 순수 인스트루멘털 버전입니다. 노래방, 배경 음악 또는 다른 보컬로 리믹스할 때 사용할 수 있습니다.
고급 AI 알고리즘이 아티팩트를 최소화하면서 깨끗한 분리를 보장합니다. 보컬 및 인스트루멘털 출력 모두 높은 오디오 품질을 유지합니다.
task ID와 audio ID를 사용해 suno/v5로 생성된 트랙과 직접 연동됩니다. 파일을 다운로드한 뒤 다시 업로드할 필요가 없습니다.
한 번의 API 호출로 분리된 보컬과 인스트루멘털 반주를 모두 받을 수 있습니다. 두 트랙 모두 원본과 시간 정렬되어 있습니다.
분리된 트랙은 고품질 MP3 형식으로 제공되어 DAWs, 비디오 편집기 또는 추가 처리에 바로 사용할 수 있습니다.
몇 가지 간단한 단계로 보컬과 반주를 분리하세요
먼저 suno/v5 API를 사용해 곡을 생성합니다. 응답에서 task ID를 확인해 두세요.
작업을 조회하여 결과를 가져옵니다. 각 작업은 2개의 오디오 변형을 생성합니다. 분리할 audio ID를 선택하세요.
task ID와 audio ID로 보컬 분리 API를 호출합니다. 나머지는 시스템이 처리합니다.
분리된 보컬 트랙과 인스트루멘털 반주를 모두 가져옵니다. 리믹스, 노래방 또는 프로덕션에 사용하세요.
최적의 보컬 분리를 위해 다음 가이드라인을 따르세요
보컬이 명확한 곡에서 분리 성능이 가장 좋습니다. 인스트루멘털 전용 트랙에는 추출할 의미 있는 보컬 콘텐츠가 없습니다.
보컬과 악기의 밸런스가 잘 잡힌 곡일수록 가장 깔끔하게 분리됩니다. 과도하게 처리되었거나 왜곡된 오디오는 아티팩트가 더 많이 발생할 수 있습니다.
분리를 요청하기 전에 소스 곡 생성이 완전히 완료되었는지 확인하세요. 작업 상태를 조회해 성공 여부를 확인하세요.
AI로 생성된 곡에서 인스트루멘털 반주 트랙을 추출하여 노래방 애플리케이션과 따라 부르기 경험에 활용할 수 있습니다.
보컬을 분리해 새로운 반주 트랙을 추가하거나, 인스트루멘털을 다른 보컬 녹음에 사용할 수 있습니다.
새로운 프로덕션에서 샘플로 사용할 특정 보컬 구절이나 인스트루멘털 요소를 추출할 수 있습니다.
음악 교육, 채보 또는 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-sdkAPI Key는 서버 측 환경 변수에 보관하세요. SDK는 이를 Bearer token으로 자동 전송하고 JSON 헤더를 추가합니다.
client.jobs.createTaskSuno로 생성된 곡에서 보컬과 반주를 분리하는 새 작업을 생성합니다.
이 예제를 사용해 선택한 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분리가 완료되었을 때 웹훅 알림을 받을 URL
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 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분리가 완료되었을 때 웹훅 알림을 받을 URL
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 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
