--- title: RunAPI를 통해 WorkBuddy에서 Suno 사용하기 — 음악 MCP 가이드 | RunAPI description: RunAPI MCP 서버를 통해 WorkBuddy에서 Suno v4~v5.5로 음악을 생성하세요. 키 1개, 보컬 모드, 비동기 폴링을 워크벤치 에이전트가 처리합니다. url: https://runapi.ai/ko/workbuddy-suno.md canonical: https://runapi.ai/ko/workbuddy-suno locale: ko site: RunAPI image: https://runapi.ai/assets/opengraph-bfaaa0f0.png alternates: en: https://runapi.ai/workbuddy-suno zh-CN: https://runapi.ai/zh-CN/workbuddy-suno es: https://runapi.ai/es/workbuddy-suno ja: https://runapi.ai/ja/workbuddy-suno de: https://runapi.ai/de/workbuddy-suno fr: https://runapi.ai/fr/workbuddy-suno pt-BR: https://runapi.ai/pt-BR/workbuddy-suno ko: https://runapi.ai/ko/workbuddy-suno it: https://runapi.ai/it/workbuddy-suno nl: https://runapi.ai/nl/workbuddy-suno pl: https://runapi.ai/pl/workbuddy-suno tr: https://runapi.ai/tr/workbuddy-suno zh-TW: https://runapi.ai/zh-TW/workbuddy-suno zh-HK: https://runapi.ai/zh-HK/workbuddy-suno ar: https://runapi.ai/ar/workbuddy-suno x-default: https://runapi.ai/workbuddy-suno model: suno --- > HTML version: https://runapi.ai/ko/workbuddy-suno > Site index for agents: https://runapi.ai/llms.txt # WorkBuddy에서 Suno를 사용하세요. Suno는 텍스트 프롬프트 또는 직접 작성한 가사로 보컬, 악기, 믹싱이 포함된 완성된 노래를 생성합니다. RunAPI를 통해 v4~v5.5 버전을 사용할 수 있으며, Suno에 공식 공개 API가 없어 RunAPI가 API 접근을 제공합니다. RunAPI를 MCP 서버로 한 번만 추가하면, WorkBuddy 에이전트가 비동기 작업을 처리하고 완성된 오디오 URL을 반환합니다. - [API Key 받기](https://runapi.ai/ko/login) - [문서 읽기](https://runapi.ai/ko/docs/guides) MCP 서버 1개 · 텍스트로 완성곡 생성 · 비동기 폴링 처리 ### 프롬프트 ```text Using the runapi MCP server, generate a song with Suno. Requirements: - Call the Suno text_to_music tool exposed by the runapi MCP server. - Set model to "suno-v5.5". - Set vocal_mode to "auto_lyrics" so the lyrics are written from my brief. - Prompt: an upbeat indie pop track about coding late at night, warm synths and acoustic guitar, female vocals. - The task is async — keep polling until the status is "completed", then give me the audio URL. ``` ### MCP 설정 ```bash { "mcp_servers": { "runapi": { "url": "https://runapi.ai/mcp", "transport": "streamable_http", "headers": { "Authorization": "Bearer $RUNAPI_API_KEY" } } } } ``` ### 응답 ```json { "task_id": "tsk_abc123", "status": "completed", "model": "suno-v5.5", "output": { "audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3", "title": "Midnight Compile", "duration_seconds": 187 } } ``` ## 세 단계로 WorkBuddy에서 Suno 사용하기 1. **RunAPI를 MCP server로 추가하기** - WorkBuddy를 실행하는 환경에서 RUNAPI_API_KEY를 설정한 후, streamable HTTP를 통해 https://runapi.ai/mcp를 가리키는 runapi라는 이름의 MCP 서버를 등록하세요. Suno는 다른 모든 RunAPI 모델과 함께 호출 가능한 음악 도구로 나타납니다 — 별도의 음악 서비스를 연결할 필요가 없습니다. `export RUNAPI_API_KEY=runapi_xxx # MCP server: runapi → https://runapi.ai/mcp ` 2. **에이전트에게 노래를 설명하세요** - WorkBuddy에게 일반 언어로 원하는 것을 말하고 모드를 지정하세요. AI가 작성한 가사를 원하면 프롬프트와 함께 auto_lyrics를, 직접 작성한 가사를 원하면 lyrics/style/title과 함께 exact_lyrics를, 보컬 없이 원하면 style/title과 함께 instrumental을 사용하세요. 에이전트가 브리프를 Suno 도구 호출에 매핑합니다. `vocal_mode: auto_lyrics` 3. **에이전트가 폴링하고 오디오를 수집하도록 두세요** - 노래 생성은 비동기이며 버전에 따라 30초에서 수 분이 소요됩니다. 워크벤치 에이전트가 상태가 completed가 될 때까지 작업을 폴링한 후, 출력 오디오 URL을 대화에 게시합니다 — task_id를 직접 다룰 필요가 없습니다. `"status": "completed"` ## Suno text_to_music 파라미터 | 파라미터 | 유형 | 설명 | | --- | --- | --- | | `model` | `string` | 필수. suno-v4, suno-v4.5, suno-v4.5-all, suno-v4.5-plus, suno-v5, 또는 suno-v5.5. | | `vocal_mode` | `string` | 필수. auto_lyrics (AI가 프롬프트로 가사 작성), exact_lyrics (가사/스타일/제목 직접 제공), 또는 instrumental (보컬 없음, 스타일/제목 필요). | | `prompt` | `string` | auto_lyrics 모드용 곡 설명. 장르, 분위기, 템포, 주제를 설명하세요. exact_lyrics 및 instrumental 모드에서는 사용 불가. | | `lyrics` | `string` | 노래할 정확한 가사. exact_lyrics 모드에서 필수. auto_lyrics 및 instrumental 모드에서는 사용 불가. | | `style` | `string` | 음악 스타일 설명, 예: lo-fi hip hop, 80s synthwave. exact_lyrics 및 instrumental 모드에서 필수. | | `vocal_gender` | `string` | 선택. male 또는 female. | | `negative_tags` | `string` | 선택. 피하고 싶은 스타일, 예: heavy metal, screaming. | ## WorkBuddy의 Suno란? Suno는 텍스트 프롬프트 또는 직접 작성한 가사로 보컬, 악기, 믹싱이 포함된 완성된 노래를 생성하는 텍스트-음악 AI입니다. 장르, 분위기, 템포를 설명하면 완성된 트랙을 받을 수 있는 작곡 스케치 패드처럼 작동합니다. Suno에 공식 공개 API가 없어 RunAPI MCP 서버를 통해 WorkBuddy가 이를 활용하며, 채팅과 이미지에 사용하는 동일한 키로 워크벤치 에이전트에게 v4~v5.5 버전에 대한 프로그래밍 방식의 접근을 제공합니다. ## Suno 활용 사례 - **YouTube 및 소셜 미디어 배경 음악** - 워크벤치 에이전트에게 분위기와 장르를 설명하여 원본 배경 트랙을 요청하세요. 라이선스 비용도 로열티 문제도 없습니다 — 트랙은 콘텐츠를 위해 새로 생성되며 URL이 WorkBuddy로 반환됩니다. - **가사를 완성된 노래로 듣기** - 작사가들은 자신의 가사를 WorkBuddy에 붙여넣고 스타일 설명과 함께 exact_lyrics 모드를 요청하여 완성된 노래로 연주되는 것을 들을 수 있습니다 — 스튜디오 녹음 전 프로덕션 데모로 활용하세요. - **팟캐스트 인트로 및 아웃트로** - 장르, 분위기, 재생 시간을 지정하여 팟캐스트의 톤에 맞는 인트로 및 아웃트로 음악을 제작하세요. 단일 대화에서 에이전트에게 여러 변형을 생성하도록 하고 가장 잘 맞는 것을 선택하세요. ## Suno + WorkBuddy 질문 ### 원하는 장르와 스타일을 얻기 위한 더 나은 Suno 프롬프트 작성 방법은? WorkBuddy에 전달하는 브리프에서 장르, 분위기, 템포, 악기 구성을 구체적으로 명시하세요. 예를 들어 "행복한 노래"보다 "어쿠스틱 기타와 따뜻한 신스가 있는 120 BPM 업비트 인디 팝"이 더 효과적입니다. 에이전트에게 negative_tags를 전달하여 헤비메탈이나 스크리밍 같은 원하지 않는 요소를 제외하도록 요청하세요. ### 어떤 Suno 버전을 사용해야 하나요 -- v4, v5, 또는 v5.5? suno-v5.5가 최신 버전으로 더 나은 보컬 명료도와 믹싱으로 가장 높은 품질의 출력을 제공합니다. suno-v4와 suno-v4.5는 초안 반복 작업에 더 저렴하고 빠릅니다. 모든 버전이 동일한 runapi MCP 서버에서 제공되므로, 프롬프트에서 다른 버전 이름을 지정하기만 하면 전환됩니다. ### WorkBuddy에서 직접 작업을 폴링해야 하나요? 아니요. Suno 작업은 비동기이지만, 워크벤치 에이전트가 수명 주기를 처리합니다 — MCP 도구를 통해 작업을 생성하고, 상태가 completed가 될 때까지 폴링한 후, 오디오 URL을 대화에 게시합니다. 노래를 설명하고 기다리기만 하면 됩니다. ### RunAPI는 공식 Suno API를 제공하나요? Suno는 공개 API를 제공하지 않습니다. RunAPI는 다른 모든 RunAPI 모델과 동일한 API 키 및 작업 라이프사이클을 통해 Suno v4부터 v5.5까지 프로그래밍 방식의 접근을 제공합니다. Suno 계정이나 별도 자격 증명이 필요하지 않습니다. ### 음성 성별과 스타일 가중치를 제어할 수 있나요? 네. vocal_gender를 male 또는 female로 요청하고, negative_tags를 사용하여 원하지 않는 스타일을 제외하세요. 더 세밀한 제어를 위해 personas endpoint를 통해 페르소나를 생성하고, 반환된 persona_id를 persona_type을 voice 또는 style로 설정하여 전달하세요. - [WorkBuddy 설정 가이드 →](https://runapi.ai/ko/workbuddy.md) - 아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요. - [RunAPI에서 Suno 보기 →](https://runapi.ai/ko/models/suno.md) - 모든 Suno 버전, 가격 및 사용 가능한 endpoint를 확인하세요. ## 지금 WorkBuddy에서 Suno를 사용해 보세요. 무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 노래를 설명하면 워크벤치 에이전트가 보컬, 악기, 믹싱이 포함된 완성된 트랙을 반환합니다. [모델 보기 →](https://runapi.ai/ko/models.md) --- ## More from RunAPI - [Home](https://runapi.ai/ko/.md) ### 제품 - [모델 카탈로그](https://runapi.ai/ko/models.md) - [요금](https://runapi.ai/ko/pricing.md) - [제공사](https://runapi.ai/ko/models#all-models) ### 개발자 - [문서](https://runapi.ai/ko/docs/guides) - [SDK](https://runapi.ai/ko/sdk.md) - [CLI](https://runapi.ai/ko/cli.md) - [MCP Server](https://runapi.ai/ko/mcp.md) - [x402](https://runapi.ai/ko/x402.md) ### 가이드 - [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md) - [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md) - [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md) ### 회사 - [엔터프라이즈](https://runapi.ai/ko/contact.md) - [문의](https://runapi.ai/ko/contact.md) ### 법적 고지 - [약관](https://runapi.ai/ko/terms.md) - [개인정보](https://runapi.ai/ko/privacy.md) - [Site index for agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Structured data ```json [ { "@context": "https://schema.org", "inLanguage": "ko", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/ko", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/ko", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/koicon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "SoftwareApplication", "name": "WorkBuddy용 RunAPI Suno", "applicationCategory": "DeveloperApplication", "description": "RunAPI MCP 서버를 통해 WorkBuddy에서 Suno v4~v5.5로 음악을 생성하세요. 키 1개, 보컬 모드, 비동기 폴링을 워크벤치 에이전트가 처리합니다.", "url": "https://runapi.ai/ko/workbuddy-suno" }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "FAQPage", "mainEntity": [ { "@type": "Question", "name": "원하는 장르와 스타일을 얻기 위한 더 나은 Suno 프롬프트 작성 방법은?", "acceptedAnswer": { "@type": "Answer", "text": "WorkBuddy에 전달하는 브리프에서 장르, 분위기, 템포, 악기 구성을 구체적으로 명시하세요. 예를 들어 \"행복한 노래\"보다 \"어쿠스틱 기타와 따뜻한 신스가 있는 120 BPM 업비트 인디 팝\"이 더 효과적입니다. 에이전트에게 negative_tags를 전달하여 헤비메탈이나 스크리밍 같은 원하지 않는 요소를 제외하도록 요청하세요." } }, { "@type": "Question", "name": "어떤 Suno 버전을 사용해야 하나요 -- v4, v5, 또는 v5.5?", "acceptedAnswer": { "@type": "Answer", "text": "suno-v5.5가 최신 버전으로 더 나은 보컬 명료도와 믹싱으로 가장 높은 품질의 출력을 제공합니다. suno-v4와 suno-v4.5는 초안 반복 작업에 더 저렴하고 빠릅니다. 모든 버전이 동일한 runapi MCP 서버에서 제공되므로, 프롬프트에서 다른 버전 이름을 지정하기만 하면 전환됩니다." } }, { "@type": "Question", "name": "WorkBuddy에서 직접 작업을 폴링해야 하나요?", "acceptedAnswer": { "@type": "Answer", "text": "아니요. Suno 작업은 비동기이지만, 워크벤치 에이전트가 수명 주기를 처리합니다 — MCP 도구를 통해 작업을 생성하고, 상태가 completed가 될 때까지 폴링한 후, 오디오 URL을 대화에 게시합니다. 노래를 설명하고 기다리기만 하면 됩니다." } }, { "@type": "Question", "name": "RunAPI는 공식 Suno API를 제공하나요?", "acceptedAnswer": { "@type": "Answer", "text": "Suno는 공개 API를 제공하지 않습니다. RunAPI는 다른 모든 RunAPI 모델과 동일한 API 키 및 작업 라이프사이클을 통해 Suno v4부터 v5.5까지 프로그래밍 방식의 접근을 제공합니다. Suno 계정이나 별도 자격 증명이 필요하지 않습니다." } }, { "@type": "Question", "name": "음성 성별과 스타일 가중치를 제어할 수 있나요?", "acceptedAnswer": { "@type": "Answer", "text": "네. vocal_gender를 male 또는 female로 요청하고, negative_tags를 사용하여 원하지 않는 스타일을 제외하세요. 더 세밀한 제어를 위해 personas endpoint를 통해 페르소나를 생성하고, 반환된 persona_id를 persona_type을 voice 또는 style로 설정하여 전달하세요." } } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "HowTo", "name": "RunAPI를 통해 WorkBuddy에서 Suno를 사용하는 방법", "description": "RunAPI를 WorkBuddy의 MCP 서버로 추가하고, 워크벤치 에이전트에게 노래를 설명하면 에이전트가 비동기 Suno 작업을 실행하고 완성된 오디오 URL을 반환합니다.", "step": [ { "@type": "HowToStep", "position": 1, "name": "RunAPI를 MCP server로 추가하기", "text": "WorkBuddy를 실행하는 환경에서 RUNAPI_API_KEY를 설정한 후, streamable HTTP를 통해 https://runapi.ai/mcp를 가리키는 runapi라는 이름의 MCP 서버를 등록하세요. Suno는 다른 모든 RunAPI 모델과 함께 호출 가능한 음악 도구로 나타납니다 — 별도의 음악 서비스를 연결할 필요가 없습니다.", "url": "https://runapi.ai/ko/workbuddy-suno#how-step-1" }, { "@type": "HowToStep", "position": 2, "name": "에이전트에게 노래를 설명하세요", "text": "WorkBuddy에게 일반 언어로 원하는 것을 말하고 모드를 지정하세요. AI가 작성한 가사를 원하면 프롬프트와 함께 auto_lyrics를, 직접 작성한 가사를 원하면 lyrics/style/title과 함께 exact_lyrics를, 보컬 없이 원하면 style/title과 함께 instrumental을 사용하세요. 에이전트가 브리프를 Suno 도구 호출에 매핑합니다.", "url": "https://runapi.ai/ko/workbuddy-suno#how-step-2" }, { "@type": "HowToStep", "position": 3, "name": "에이전트가 폴링하고 오디오를 수집하도록 두세요", "text": "노래 생성은 비동기이며 버전에 따라 30초에서 수 분이 소요됩니다. 워크벤치 에이전트가 상태가 completed가 될 때까지 작업을 폴링한 후, 출력 오디오 URL을 대화에 게시합니다 — task_id를 직접 다룰 필요가 없습니다.", "url": "https://runapi.ai/ko/workbuddy-suno#how-step-3" } ] }, { "@context": "https://schema.org", "inLanguage": "ko", "@type": "BreadcrumbList", "itemListElement": [ { "@type": "ListItem", "position": 1, "name": "홈", "item": "https://runapi.ai/ko" }, { "@type": "ListItem", "position": 2, "name": "WorkBuddy용 RunAPI Suno", "item": "https://runapi.ai/ko/workbuddy-suno" } ] } ] ```