Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 오디오가 없습니다. 폼을 제출해 오디오를 생성하세요.
다양한 사용 사례와 매개변수 구성을 살펴보세요
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
Suno extend musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 사용 전체 가이드
기존 AI 생성 곡을 매끄럽게 이어 확장하고, 음악적 일관성을 유지하면서 새로운 섹션을 추가하세요.
Suno V5_5 Extension API를 사용하면 Suno V5_5로 이전에 생성한 곡을 확장할 수 있습니다. 이 기능을 통해 원본 트랙의 어느 지점에서든 자연스럽게 이어지는 새로운 섹션을 추가하여 더 긴 곡을 만들 수 있습니다. 또 다른 절을 추가하거나, 아웃트로를 늘리거나, 클라이맥스에 이르는 마무리를 구성하고 싶을 때, Extension API는 원곡의 음악 스타일, 키, 템포, 분위기를 유지하면서 새로운 콘텐츠를 생성합니다.
AI가 원본 파라미터를 사용해 곡을 자동으로 이어가도록 합니다. 소스 트랙과 완벽한 일관성을 유지하는 빠른 확장에 적합합니다.
시작 지점, 새 프롬프트, 스타일, 제목을 지정하여 직접 제어할 수 있습니다. 곡이 어떻게 전개되고 변화할지 창의적으로 제어하는 데 이상적입니다.
확장된 부분이 원본 트랙과 자연스럽게 어우러지며, 템포, 키, 스타일을 맞춰 전문적인 느낌의 더 긴 곡을 만들어냅니다.
확장을 시작할 위치를 정확히 선택하세요. 끝부분부터 이어가거나, 아웃트로와 겹치게 하거나, 곡의 어느 순간에서든 새롭게 분기할 수 있습니다.
원래 스타일을 유지하거나 사용자 지정 파라미터로 발전시킬 수 있습니다. 에너지를 고조시키고, 다른 분위기로 전환하거나, 새로운 음악 요소를 추가하세요.
곡을 여러 번 확장하여 대서사시처럼 긴 트랙을 만들 수 있습니다. 각 확장은 다시 확장할 수 있어 복잡한 곡 구조를 구현할 수 있습니다.
몇 가지 간단한 단계로 AI 생성 곡을 확장하세요
먼저 suno/generate API를 사용해 곡을 생성하세요. 확장하려는 트랙의 응답에서 audio ID를 확인해 두세요.
자동 확장(원본 파라미터 사용) 또는 사용자 지정 확장(직접 지정한 파라미터 사용) 중에서 선택하세요.
사용자 지정 확장의 경우, 확장이 시작될 continueAt 시간을 초 단위로 지정하세요.
audio ID와 선택한 파라미터로 API를 호출하세요. 지정한 지점부터 확장이 매끄럽게 생성됩니다.
확장된 오디오 파일을 가져오세요. 결과에는 원본 콘텐츠와 새 확장이 포함되어 하나의 완성된 트랙으로 제공됩니다.
매끄러운 곡 확장을 위해 다음 가이드를 따르세요
가장 매끄러운 결과를 위해 프레이즈의 끝, 코러스 이후, 또는 악기 연주 구간처럼 자연스러운 전환 지점에서 확장하세요.
사용자 지정 모드에서는 음악이 어떻게 발전해야 하는지 설명하세요. 에너지를 고조시키거나, 악기를 추가하거나, 브리지로 전환하거나, 아웃트로를 위해 서서히 마무리할 수 있습니다.
사용자 지정 파라미터를 사용할 때는 일관된 결과를 위해 원곡과 유사한 스타일을 유지하거나, 역동적인 전환을 위해 의도적으로 대비를 줄 수 있습니다.
초기 생성물을 확장하여 완성도 높은 4-5분 길이의 곡을 만들 수 있으며, 상업용 음악 제작에 적합합니다.
DJ 믹싱, 라이브 공연, 확장된 댄스 버전에 적합하도록 변주가 포함된 트랙을 확장하세요.
확장을 연결해 비디오, 게임, 멀티미디어 프로젝트를 위한 더 긴 배경음악을 제작하세요.
서로 다른 지점에서 다양한 스타일로 확장하여 곡의 대안 버전을 만들 수 있습니다.
suno/generate로 생성된 트랙과 완벽하게 연동됩니다. 원곡 생성과 확장에 동일한 API key와 워크플로를 사용하세요.
전체 곡을 다시 생성하지 않고 더 긴 곡을 만들 수 있습니다. 확장은 새로 생성된 콘텐츠를 기준으로 합리적으로 가격이 책정됩니다.
확장은 원본 Suno V5_5 생성물과 동일한 높은 품질을 유지하며, 오디오가 매끄럽게 이어집니다.
모든 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.createTask기존 Suno V5 생성 곡을 확장하는 새 작업을 생성합니다
이 예제를 사용해 선택한 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/extend",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "audioId": "abc123-def456-ghi789",
12 "continueAt": 120,
13 "prompt": "Build up to a powerful chorus with harmonies and drums",
14 "style": "Pop Rock, Uplifting, Anthemic",
15 "title": "Rise Again (Extended)"
16 }
17});
18
19console.log(task.data.taskId);API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "suno/extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 | V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioId": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "personaId": "string",
13 "negativeTags": "string",
14 "styleWeight": "number",
15 "weirdnessConstraint": "number",
16 "audioWeight": "number"
17 },
18 "channel": "auto"
19}model필수stringSuno V5 확장을 위한 모델 식별자
"suno/extend"
callBackUrl선택적string확장이 완료되었을 때 웹훅 알림을 받을 URL
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구사항이 없는 한 기본 auto 값을 유지하세요.
사용 가능한 옵션:
auto
기존 곡을 확장하기 위한 파라미터:
input.model_version선택적string사용할 Suno 모델 버전입니다. 기본값은 V5(최신)입니다.
사용 가능한 옵션:
"V5"
input.audioId필수string확장할 원본 오디오 트랙의 ID입니다. 이전 suno/v5 생성 결과에서 얻습니다.
"abc123-def456-ghi789"
input.instrumental선택적boolean보컬 없이 연주곡 확장을 생성합니다.
false
input.continueAt필수integer확장을 시작할 시간 지점(초)입니다. 필수
0보다 커야 합니다
120
input.prompt필수string확장 섹션에 대한 설명입니다.
V4: 최대 3000자 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 5000자
"Build up to a powerful chorus with harmonies"
input.style필수string확장에 사용할 음악 스타일입니다. 필수
V4: 최대 200자 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 1000자
"Pop Rock, Uplifting"
input.title선택적string확장된 트랙의 제목입니다. 필수
최대 길이: 80자
"Rise Again (Extended)"
input.vocalGender선택적string확장에 사용할 보컬 성별입니다.
사용 가능한 옵션:
"f"
input.personaId선택적string생성된 곡에 사용할 페르소나 ID입니다.
customMode=true일 때만 유효합니다.
"1234567890"
input.negativeTags선택적string생성에서 제외할 스타일 또는 특징입니다.
customMode=true일 때만 유효합니다.
"aggressive, heavy metal, screaming"
input.styleWeight선택적number스타일을 얼마나 엄격하게 따를지 지정합니다. 범위: 0.0-1.0
customMode=true일 때만 유효합니다. customMode=false일 때는 무시됩니다. 0.00에서 1.00 사이의 숫자입니다. 0.01 단위로 입력해야 합니다. Boolean 값은 허용되지 않습니다.
0.5
input.weirdnessConstraint선택적number창의성 수준을 제어합니다. 값이 높을수록 더 실험적인 결과가 생성됩니다. 범위: 0.0-1.0
customMode=true일 때만 유효합니다. customMode=false일 때는 무시됩니다. 0.00에서 1.00 사이의 숫자입니다. 0.01 단위로 입력해야 합니다. Boolean 값은 허용되지 않습니다.
0.3
input.audioWeight선택적number생성에 대한 오디오 영향 가중치입니다. 범위: 0.0-1.0
customMode=true일 때만 유효합니다. customMode=false일 때는 무시됩니다. 0.00에서 1.00 사이의 숫자입니다. 0.01 단위로 입력해야 합니다. Boolean 값은 허용되지 않습니다.
0.5
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_extend_xyz789"
6 }
7}code상태 코드, 성공 시 200
message응답 메시지
data.taskId확장 상태를 조회하기 위한 작업 ID
확장이 완료되면 callBackUrl로 POST 요청이 전송됩니다
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "success",
6 "completeTime": 1755599700000,
7 "costTime": 50000,
8 "model": "suno/extend",
9 "resultJson": {
10 "data": [
11 {
12 "id": "audio_ext_001",
13 "audio_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_audio.mp3",
14 "image_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_cover.jpeg",
15 "duration": 240.5
16 }
17 ]
18 }
19 },
20 "msg": "Extension completed successfully."
21}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "fail",
6 "failCode": "INVALID_AUDIO_ID",
7 "failMsg": "Source audio ID not found or expired"
8 },
9 "msg": "Extension 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_extend_xyz789");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_extend_xyz789",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_ext_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_extend_xyz789_0_cover.jpeg",
12 "duration": 240.5
13 }
14 ]
15 }
16 }
17}data.state현재 상태: queuing, generating, success 또는 fail
data.resultJson.dataURL 및 메타데이터가 포함된 확장 오디오 트랙 배열
API 페이지는 매개변수 스키마를 보여주지만, Suno는 누락하기 쉬운 여러 비즈니스 특화 모드 조합 및 콜백 규칙도 가지고 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
기존 Suno V5 생성 곡을 확장하는 새 작업을 생성합니다
API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "suno/extend",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 | V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "audioId": "string (required)",
7 "instrumental": "boolean",
8 "continueAt": "integer",
9 "prompt": "string",
10 "style": "string",
11 "title": "string",
12 "personaId": "string",
13 "negativeTags": "string",
14 "styleWeight": "number",
15 "weirdnessConstraint": "number",
16 "audioWeight": "number"
17 },
18 "channel": "auto"
19}model필수stringSuno V5 확장을 위한 모델 식별자
"suno/extend"
callBackUrl선택적string확장이 완료되었을 때 웹훅 알림을 받을 URL
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 비디오 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체에 작업을 자동 배분하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구사항이 없는 한 기본 auto 값을 유지하세요.
사용 가능한 옵션:
auto
기존 곡을 확장하기 위한 파라미터:
input.model_version선택적string사용할 Suno 모델 버전입니다. 기본값은 V5(최신)입니다.
사용 가능한 옵션:
"V5"
input.audioId필수string확장할 원본 오디오 트랙의 ID입니다. 이전 suno/v5 생성 결과에서 얻습니다.
"abc123-def456-ghi789"
input.instrumental선택적boolean보컬 없이 연주곡 확장을 생성합니다.
false
input.continueAt필수integer확장을 시작할 시간 지점(초)입니다. 필수
0보다 커야 합니다
120
input.prompt필수string확장 섹션에 대한 설명입니다.
V4: 최대 3000자 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 5000자
"Build up to a powerful chorus with harmonies"
input.style필수string확장에 사용할 음악 스타일입니다. 필수
V4: 최대 200자 V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 1000자
"Pop Rock, Uplifting"
input.title선택적string확장된 트랙의 제목입니다. 필수
최대 길이: 80자
"Rise Again (Extended)"
input.vocalGender선택적string확장에 사용할 보컬 성별입니다.
사용 가능한 옵션:
"f"
input.personaId선택적string생성된 곡에 사용할 페르소나 ID입니다.
customMode=true일 때만 유효합니다.
"1234567890"
input.negativeTags선택적string생성에서 제외할 스타일 또는 특징입니다.
customMode=true일 때만 유효합니다.
"aggressive, heavy metal, screaming"
input.styleWeight선택적number스타일을 얼마나 엄격하게 따를지 지정합니다. 범위: 0.0-1.0
customMode=true일 때만 유효합니다. customMode=false일 때는 무시됩니다. 0.00에서 1.00 사이의 숫자입니다. 0.01 단위로 입력해야 합니다. Boolean 값은 허용되지 않습니다.
0.5
input.weirdnessConstraint선택적number창의성 수준을 제어합니다. 값이 높을수록 더 실험적인 결과가 생성됩니다. 범위: 0.0-1.0
customMode=true일 때만 유효합니다. customMode=false일 때는 무시됩니다. 0.00에서 1.00 사이의 숫자입니다. 0.01 단위로 입력해야 합니다. Boolean 값은 허용되지 않습니다.
0.3
input.audioWeight선택적number생성에 대한 오디오 영향 가중치입니다. 범위: 0.0-1.0
customMode=true일 때만 유효합니다. customMode=false일 때는 무시됩니다. 0.00에서 1.00 사이의 숫자입니다. 0.01 단위로 입력해야 합니다. Boolean 값은 허용되지 않습니다.
0.5
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/extend",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "audioId": "abc123-def456-ghi789",
9 "continueAt": 120,
10 "prompt": "Build up to a powerful chorus with harmonies and drums",
11 "style": "Pop Rock, Uplifting, Anthemic",
12 "title": "Rise Again (Extended)"
13 }
14 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_extend_xyz789"
6 }
7}code상태 코드, 성공 시 200
message응답 메시지
data.taskId확장 상태를 조회하기 위한 작업 ID
