Cookie Preferences
We use cookies to personalize content and analyze traffic. See our Cookie Policy.
아직 출력이 없습니다. 폼을 제출해 콘텐츠를 생성하세요.
다양한 사용 사례와 매개변수 구성을 살펴보세요
숨겨진 수수료 없이 투명한 가격. 사용량에 따라 지불합니다.
| 규칙 및 양식 | Channel | 크레딧 | 가격 (USD) | 공식/참고 가격 | 일일 절감액 |
|---|---|---|---|---|---|
Suno lyrics musicSuno | Starter | 1per run | $0.005 | - | - |
Suno 사용 전체 가이드
AI로 완성도 높은 노래 가사를 생성하세요. 테마와 분위기에 대한 간단한 설명만으로 벌스, 코러스, 브리지 등 다양한 파트를 만들 수 있습니다.
Suno Lyrics API는 사용자의 설명을 바탕으로 오리지널 노래 가사를 생성합니다. 원하는 테마, 분위기, 구조를 간단히 설명하면 AI가 벌스, 코러스, 브리지 및 기타 곡 섹션으로 구성된 완성형 가사를 만들어 줍니다. 생성된 가사에는 추천 제목과 스타일이 포함되어 있어 Suno 음악 생성 API 또는 기타 음악 제작 워크플로에서 바로 사용할 수 있습니다. 영감을 찾는 작곡가, 맞춤형 가사가 필요한 콘텐츠 크리에이터, 음악 애플리케이션을 개발하는 개발자에게 적합합니다.
벌스, 프리코러스, 코러스, 브리지, 아웃트로가 포함된 완전한 구조의 가사를 생성합니다. AI는 곡 형식을 이해하고 일관된 서사 흐름을 만들어 냅니다.
어떤 테마, 분위기, 스타일이든 설명해 보세요. 사랑 노래부터 저항가, 팝부터 힙합까지, AI가 사용자의 비전에 맞춰 작사 스타일을 조정합니다.
테마, 감정, 이야기 요소 등 원하는 곡을 일상적인 언어로 설명하면 AI가 그 비전을 구조화되고 노래하기 쉬운 가사로 해석합니다.
AI가 음악 제작에 쉽게 활용할 수 있도록 명확한 마커([Verse 1], [Chorus], [Bridge] 등)가 포함된 적절한 곡 섹션으로 가사를 구성합니다.
생성된 각 가사에는 음악 생성 API에서 바로 사용할 수 있는 추천 제목과 스타일 설명이 포함됩니다.
가사는 음악에 얹었을 때 잘 어울리도록 자연스러운 라임 패턴과 리듬감 있는 흐름으로 작성됩니다.
몇 단계만으로 AI 생성 노래 가사를 만들어 보세요
원하는 가사에 대한 설명을 작성하세요. 테마, 분위기, 스타일, 포함하고 싶은 특정 요소나 이야기 포인트를 넣으면 좋습니다.
프롬프트와 함께 API를 호출하세요. AI가 설명을 분석하고 이에 맞는 가사를 생성합니다.
제목, 스타일, 서식이 지정된 섹션이 포함된 구조화된 가사를 받습니다. 바로 사용하거나 추가로 맞춤 수정할 수 있습니다.
생성된 가사를 suno/v5 음악 생성의 custom mode 프롬프트로 사용해 완성된 곡을 만들어 보세요.
최적의 가사 생성을 위해 다음 가이드를 따르세요
'슬픈 노래'라고만 하기보다, '어린 시절 살던 집을 잃고 그곳에 남겨진 추억을 담은 노래'처럼 구체적인 상황을 설명하세요.
감정적 톤과 장르를 지정하세요. '자동차 여행에 관한 밝은 컨트리 노래'는 단순히 '자동차 여행 노래'라고 하는 것보다 더 좋은 결과를 제공합니다.
특정 섹션을 원한다면 '강렬한 브리지 섹션 포함' 또는 '콜 앤 리스폰스 코러스 포함'처럼 언급하세요.
AI가 생성한 가사를 자신의 작곡을 위한 출발점으로 활용하세요. 편집하고 다듬어 나만의 가사로 만들 수 있습니다.
먼저 가사를 생성한 다음 suno/v5와 함께 사용해 이에 어울리는 음악이 포함된 완성곡을 제작하세요.
결혼식, 생일, 기업 행사, 특별한 날을 위한 개인화된 노래를 만들어 보세요.
곡 구조, 라임 구성, 작사 기법을 가르치기 위한 예시 가사를 생성하세요.
몇 초 만에 완성된 가사를 얻을 수 있습니다. 빠른 아이디어 도출과 브레인스토밍 세션에 적합합니다.
가사는 제목, 스타일, 적절한 서식과 함께 제공됩니다. 음악 생성에 바로 사용하거나 다른 용도로 내보낼 수 있습니다.
suno/v5 음악 생성과 완벽하게 연동됩니다. 가사를 생성한 뒤 하나의 통합 워크플로에서 음악까지 제작하세요.
모든 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.createTaskAI 가사를 생성하기 위한 새 작업을 생성합니다
이 예제를 사용해 선택한 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/lyrics",
9 "callBackUrl": "https://your-domain.com/api/callback",
10 "input": {
11 "prompt": "A love song about meeting someone at a coffee shop, romantic and upbeat mood, with catchy chorus"
12 }
13});
14
15console.log(task.data.taskId);API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "suno/lyrics",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "prompt": "string (required)"
6 },
7 "channel": "auto"
8}model필수stringSuno 가사 생성을 위한 모델 식별자
"suno/lyrics"
callBackUrl선택적string생성이 완료되었을 때 webhook 알림을 수신할 URL
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내의 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 전반에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없는 한 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
가사 생성을 위한 파라미터:
input.prompt필수string생성할 가사에 대한 설명입니다. 주제, 분위기, 스타일, 구조 선호도를 포함하세요.
허용되는 별칭: lyricPrompt, lyric_prompt.
"A love song about meeting someone at a coffee shop, romantic and upbeat mood"
1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_lyrics_abc123"
6 }
7}code상태 코드, 성공 시 200
message응답 메시지
data.taskId가사 생성 상태를 조회하기 위한 작업 ID
가사 생성이 완료되면 callBackUrl로 POST 요청이 전송됩니다
1{
2 "code": 200,
3 "data": {
4 "taskId": "task_lyrics_abc123",
5 "state": "success",
6 "completeTime": 1755599650000,
7 "costTime": 5000,
8 "model": "suno/lyrics",
9 "resultJson": {
10 "data": {
11 "title": "Coffee Shop Love",
12 "style": "Pop, Romantic, Upbeat",
13 "lyrics": "[Verse 1]\nMorning light through the window pane\nYou walked in and I lost my name...\n\n[Chorus]\nMeet me at the coffee shop\nWhere our story's just begun..."
14 }
15 }
16 },
17 "msg": "Lyrics generation completed successfully."
18}1{
2 "code": 501,
3 "data": {
4 "taskId": "task_lyrics_abc123",
5 "state": "fail",
6 "failCode": "CONTENT_POLICY",
7 "failMsg": "Prompt violates content policy"
8 },
9 "msg": "Lyrics generation 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_lyrics_abc123");
8
9console.log(result.data.state);
10console.log(result.data.resultJson);1{
2 "code": 200,
3 "data": {
4 "taskId": "task_lyrics_abc123",
5 "state": "success",
6 "resultJson": {
7 "data": {
8 "title": "Coffee Shop Love",
9 "style": "Pop, Romantic, Upbeat",
10 "lyrics": "[Verse 1]\nMorning light through the window pane\nYou walked in and I lost my name\nWith a smile that stopped the world\nMy heart skipped, my thoughts unfurled\n\n[Chorus]\nMeet me at the coffee shop\nWhere our story's just begun\nEvery moment with you feels like\nWe're dancing in the sun"
11 }
12 }
13 }
14}data.state현재 상태: queuing, generating, success 또는 fail
data.resultJson.data.titleAI가 제안한 곡 제목
data.resultJson.data.style가사에 대해 AI가 제안한 스타일/장르
data.resultJson.data.lyrics섹션 마커가 포함된 생성된 가사
API 페이지는 매개변수 스키마를 보여주지만, Suno는 누락하기 쉬운 여러 비즈니스 특화 모드 조합 및 콜백 규칙도 가지고 있습니다.
모든 API는 Bearer Token을 통한 인증이 필요합니다.
Authorization: Bearer
AI 가사를 생성하기 위한 새 작업을 생성합니다
API는 다음 구조의 JSON 페이로드를 받습니다:
1{
2 "model": "suno/lyrics",
3 "callBackUrl": "string (optional)",
4 "input": {
5 "prompt": "string (required)"
6 },
7 "channel": "auto"
8}model필수stringSuno 가사 생성을 위한 모델 식별자
"suno/lyrics"
callBackUrl선택적string생성이 완료되었을 때 webhook 알림을 수신할 URL
"https://your-domain.com/api/callback"
channel선택적stringchannel 파라미터를 통해 APIPASS 내의 해당 제공업체를 지정할 수 있습니다. 이러한 제공업체는 실제 이미지 및 동영상 생성 작업을 처리합니다. APIPASS는 현재 세 가지 제공업체 옵션을 제공합니다:
channel 파라미터의 기본값은 auto입니다. 활성화하면 APIPASS가 실시간 가격 및 안정성 지표를 기반으로 사용 가능한 제공업체 전반에 작업을 자동으로 할당하여 최소 비용과 안정적인 성능의 균형을 맞춥니다. 사용자 지정 라우팅 요구 사항이 없는 한 기본값 auto를 유지하세요.
사용 가능한 옵션:
auto
가사 생성을 위한 파라미터:
input.prompt필수string생성할 가사에 대한 설명입니다. 주제, 분위기, 스타일, 구조 선호도를 포함하세요.
허용되는 별칭: lyricPrompt, lyric_prompt.
"A love song about meeting someone at a coffee shop, romantic and upbeat mood"
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/lyrics",
6 "callBackUrl": "https://your-domain.com/api/callback",
7 "input": {
8 "prompt": "A love song about meeting someone at a coffee shop, romantic and upbeat mood, with catchy chorus"
9 }
10 }'1{
2 "code": 200,
3 "message": "success",
4 "data": {
5 "taskId": "task_lyrics_abc123"
6 }
7}code상태 코드, 성공 시 200
message응답 메시지
data.taskId가사 생성 상태를 조회하기 위한 작업 ID
