Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 오디오가 없습니다. 폼을 제출해 오디오를 생성하세요.
다양한 사용 사례와 매개변수 구성을 살펴보세요
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
Suno generate musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 사용 전체 가이드
ApiPass의 `suno/generate`를 사용하면 자연어 설명 한 줄을 완성형 곡으로 바꿀 수 있습니다. 보컬곡, 연주곡, 광고 배경음악, 빠른 데모 제작까지 하나의 작업형 API, 비동기 조회, 안정적인 웹훅으로 처리할 수 있습니다.
Suno Generate는 Suno의 텍스트 기반 음악 생성 기능입니다. 프롬프트만으로 완성된 곡을 만들 수 있고, 스타일, 제목, 연주곡 여부, 보컬 성별까지 제어할 수 있습니다. 고급 모드에서는 스타일 강도, 창의성 수준, 제외할 태그도 조정할 수 있습니다. ApiPass를 사용하면 Suno V5_5, V4.5PLUS, V4.5ALL, V4.5, V4를 하나의 API로 호출할 수 있습니다.
주제, 분위기, 템포, 장면을 한 문장으로 설명하면 완성도 있는 곡을 생성할 수 있습니다. 아이디어 탐색, 빠른 마케팅 콘텐츠 제작, 프롬프트 기반 음악 생성 서비스에 적합합니다.
`customMode`를 활성화하고 `style`, `title`을 명시하면 장르와 결과물의 일관성을 더 높일 수 있습니다. 대량 생성, 템플릿 기반 제작, 브랜드 콘텐츠 운영에 유리합니다.
음악 생성에는 보통 수십 초가 필요하므로 ApiPass는 Suno를 작업 기반으로 제공합니다. `/api/v1/jobs/recordInfo`를 폴링하거나 `callBackUrl`로 웹훅을 받아 후속 파이프라인을 자동으로 이어갈 수 있습니다.
프롬프트와 일치하는 일관된 가사와 AI가 부르는 보컬이 포함된 완벽한 노래를 생성합니다. Suno V5_5 모델은 다양한 언어와 스타일로 자연스러운 보컬을 만듭니다.
보컬이 없는 순수한 기악 트랙을 만듭니다. 배경 음악, 게임 사운드트랙, 명상 앱 및 가사 없는 음악이 필요한 모든 사용 사례에 적합합니다.
팝, 록, 힙합부터 클래식, 일렉트로닉, 월드 뮤직에 이르기까지 수백 가지 음악 장르를 지원합니다. 여러 스타일을 결합하고 네거티브 태그를 사용하여 원하지 않는 요소를 제외할 수 있습니다.
창작 비전에 맞춰 남성 보컬과 여성 보컬 중 선택하세요. AI는 음악 스타일에 적응하는 자연스러운 목소리를 제공합니다.
스타일 가중치, 기이함 제약 조건, 오디오 가중치 매개변수를 사용하여 창작물을 미세 조정하세요. 프롬프트를 엄격하게 따르는 것과 창의적인 탐구 사이에서 균형을 맞춥니다.
다음과 같은 흐름은 `suno/generate`, 비동기 작업, 웹훅 조합에 특히 잘 맞습니다.
사용자의 짧은 프롬프트 하나로 두 개의 곡 후보를 받아볼 수 있어 창작 보조 도구나 인터랙티브 서비스에 적합합니다.
광고 문구, 제품 포인트, 캠페인 콘셉트를 스타일화된 음악으로 바꿔 마케팅 제작 효율을 높일 수 있습니다.
우선 taskId를 반환하고, 이후 웹훅으로 받은 오디오 URL, 커버, 메타데이터를 서비스 시스템에 기록하는 흐름을 구성할 수 있습니다.
여러 변형 곡을 기반으로 내부 검토, 선별, 게시 흐름에 자연스럽게 연결되는 콘텐츠 제작 파이프라인을 만들 수 있습니다.
처음부터 새 곡을 만드는지, 기존 결과물을 이어서 사용하는지에 따라 적절한 엔드포인트가 달라집니다.
먼저 가사 텍스트만 만들고 싶다면 `suno/lyrics`가 더 적합합니다. 오디오와 커버 이미지를 포함한 완성곡을 바로 얻고 싶다면 `suno/generate`를 사용해야 합니다.
`suno/generate`는 새로운 곡을 처음부터 만드는 용도입니다. 기존 Suno 곡을 이어서 만들려면 `suno/extend`, 기존 오디오를 다른 스타일로 다시 만들려면 `suno/cover`가 더 적합합니다.
짧은 아이디어를 곡으로 바꾸고 여러 스타일을 빠르게 비교해 볼 수 있는 창작 보조 도구를 만들 수 있습니다.
캠페인 문구, 제품 설명, 영상 콘셉트에서 자동으로 배경음악을 생성해 광고와 콘텐츠 제작 속도를 높일 수 있습니다.
장면, 캐릭터 설정, 이벤트 설명에 맞는 음악 초안을 빠르게 만들고 검증해 볼 수 있습니다.
작업 큐, CMS, 자동화 서버와 연결해 사용자는 기다리지 않고 백그라운드에서 음악을 생성한 뒤 결과만 전달받도록 구성할 수 있습니다.
ApiPass 대시보드에서 API Key를 발급하세요. 이후 모든 `suno/generate` 요청은 이 키로 인증됩니다.
`/api/v1/jobs/createTask`에 `model: "suno/generate"`를 포함한 요청을 보내고, `input` 안에 prompt, style, title 등의 파라미터를 전달합니다. 응답으로 즉시 `taskId`를 받게 됩니다.
`taskId`로 `/api/v1/jobs/recordInfo`를 폴링하거나 `callBackUrl`을 설정해 웹훅을 받을 수 있습니다. 완료 후에는 오디오 URL, 커버 이미지, 곡 메타데이터를 확인할 수 있습니다.
모든 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/generate",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
12 "customMode": false,
13 "instrumental": false,
14 "vocalGender": "f"
15 }
16});
17
18console.log(task.data.taskId);API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}model필수stringSuno V5 음악 생성을 위한 모델 식별자
"suno/generate"
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.prompt선택적string생성할 음악에 대한 텍스트 설명입니다. customMode가 false이거나, customMode가 true이고 instrumental이 false인 경우 필수입니다.
customMode=false: prompt는 필수이며 최대 500자입니다. customMode=true + instrumental=false: prompt는 필수입니다. customMode=true + instrumental=true: prompt는 선택 사항입니다. customMode=true의 경우: V4: 최대 3000자; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 5000자
"A catchy pop song about summer love with upbeat tempo"
input.customMode선택적boolean더 세밀하게 제어할 수 있도록 사용자 지정 모드를 활성화합니다. true인 경우 style과 title이 필수입니다.
customMode=false인 경우 style과 title은 무시되며 제공자에게 전송되지 않습니다.
매개변수 모드:
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumental선택적boolean보컬 없이 연주곡을 생성합니다.
false
input.style선택적string음악 스타일/장르입니다. customMode가 true인 경우 필수입니다.
customMode=true인 경우 필수입니다. customMode=false인 경우 무시됩니다. V4: 최대 200자; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 1000자
"Pop, Upbeat, Summer Vibes"
input.title선택적string생성된 음악의 제목입니다. customMode가 true인 경우 필수입니다.
최대 길이: 80자
"Summer Love"
input.vocalGender선택적string생성된 곡 보컬의 성별입니다.
customMode=true인 경우에만 유효합니다.
사용 가능한 옵션:
"f"
input.personaId선택적string생성된 곡에 사용할 Persona 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_abc123xyz"
6 }
7}code상태 코드, 성공 시 200
message응답 메시지
data.taskId상태와 결과를 조회하기 위한 고유 작업 ID
생성이 완료되면 callBackUrl로 POST 요청이 전송됩니다
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "completeTime": 1755599644000,
7 "costTime": 45000,
8 "createTime": 1755599599000,
9 "model": "suno/generate",
10 "resultJson": {
11 "data": [
12 {
13 "id": "audio_001",
14 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
15 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
16 "duration": 180.5,
17 "title": "Summer Love",
18 "style": "Pop"
19 },
20 {
21 "id": "audio_002",
22 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_audio.mp3",
23 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_1_cover.jpeg",
24 "duration": 175.2,
25 "title": "Summer Love",
26 "style": "Pop"
27 }
28 ]
29 }
30 },
31 "msg": "Task completed successfully."
32}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "fail",
6 "failCode": "GENERATION_FAILED",
7 "failMsg": "Music generation failed due to content policy violation"
8 },
9 "msg": "Task 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_abc123xyz");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_abc123xyz",
5 "state": "success",
6 "resultJson": {
7 "data": [
8 {
9 "id": "audio_001",
10 "audio_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_audio.mp3",
11 "image_url": "https://cdn.apipass.dev/results/task_abc123xyz_0_cover.jpeg",
12 "duration": 180.5
13 }
14 ]
15 }
16 }
17}code상태 코드, 성공 시 200
data.taskId작업 ID
data.state현재 상태: queuing, generating, success 또는 fail
data.resultJson.dataURL 및 메타데이터가 포함된 생성된 오디오 트랙 배열
API 페이지는 매개변수 스키마를 보여주지만, Suno는 누락하기 쉬운 여러 비즈니스 특화 모드 조합 및 콜백 규칙도 가지고 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
새 Suno V5 음악 생성 작업을 생성합니다
API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "suno/generate",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "model_version": "V5_5 |V5 | V4_5PLUS | V4_5ALL | V4_5 | V4",
6 "prompt": "string",
7 "customMode": "boolean",
8 "instrumental": "boolean",
9 "style": "string",
10 "title": "string",
11 "vocalGender": "m | f",
12 "negativeTags": "string",
13 "styleWeight": "number",
14 "weirdnessConstraint": "number",
15 "audioWeight": "number"
16 },
17 "channel": "auto"
18}model필수stringSuno V5 음악 생성을 위한 모델 식별자
"suno/generate"
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.prompt선택적string생성할 음악에 대한 텍스트 설명입니다. customMode가 false이거나, customMode가 true이고 instrumental이 false인 경우 필수입니다.
customMode=false: prompt는 필수이며 최대 500자입니다. customMode=true + instrumental=false: prompt는 필수입니다. customMode=true + instrumental=true: prompt는 선택 사항입니다. customMode=true의 경우: V4: 최대 3000자; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 5000자
"A catchy pop song about summer love with upbeat tempo"
input.customMode선택적boolean더 세밀하게 제어할 수 있도록 사용자 지정 모드를 활성화합니다. true인 경우 style과 title이 필수입니다.
customMode=false인 경우 style과 title은 무시되며 제공자에게 전송되지 않습니다.
매개변수 모드:
customMode=false + instrumental=false
promptcustomMode=false + instrumental=true
promptcustomMode=true + instrumental=false
styletitlepromptcustomMode=true + instrumental=true
styletitlepromptfalse
input.instrumental선택적boolean보컬 없이 연주곡을 생성합니다.
false
input.style선택적string음악 스타일/장르입니다. customMode가 true인 경우 필수입니다.
customMode=true인 경우 필수입니다. customMode=false인 경우 무시됩니다. V4: 최대 200자; V5_5, V5, V4_5PLUS, V4_5ALL, V4_5: 최대 1000자
"Pop, Upbeat, Summer Vibes"
input.title선택적string생성된 음악의 제목입니다. customMode가 true인 경우 필수입니다.
최대 길이: 80자
"Summer Love"
input.vocalGender선택적string생성된 곡 보컬의 성별입니다.
customMode=true인 경우에만 유효합니다.
사용 가능한 옵션:
"f"
input.personaId선택적string생성된 곡에 사용할 Persona 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/generate",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A catchy pop song about summer love with upbeat tempo and cheerful melody",
9 "customMode": false,
10 "instrumental": false,
11 "vocalGender": "f"
12 }
13 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_abc123xyz"
6 }
7}code상태 코드, 성공 시 200
message응답 메시지
data.taskId상태와 결과를 조회하기 위한 고유 작업 ID
