Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

WORKBUDDY + SUNO

WorkBuddy에서 Suno를 사용하세요.

Suno는 텍스트 프롬프트 또는 직접 작성한 가사로 보컬, 악기, 믹싱이 포함된 완성된 노래를 생성합니다. RunAPI를 통해 v4~v5.5 버전을 사용할 수 있으며, Suno에 공식 공개 API가 없어 RunAPI가 API 접근을 제공합니다. RunAPI를 MCP 서버로 한 번만 추가하면, WorkBuddy 에이전트가 비동기 작업을 처리하고 완성된 오디오 URL을 반환합니다.

API Key 받기 문서 읽기
MCP 서버 1개 · 텍스트로 완성곡 생성 · 비동기 폴링 처리 
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_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": {
        "Authorization": "Bearer $RUNAPI_API_KEY"
      }
    }
  }
}

{
  "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
  }
}
연결할 MCP 설정 복사 suno
작동 방식

세 단계로 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 모드를 요청하여 완성된 노래로 연주되는 것을 들을 수 있습니다 — 스튜디오 녹음 전 프로덕션 데모로 활용하세요.

팟캐스트 인트로 및 아웃트로

장르, 분위기, 재생 시간을 지정하여 팟캐스트의 톤에 맞는 인트로 및 아웃트로 음악을 제작하세요. 단일 대화에서 에이전트에게 여러 변형을 생성하도록 하고 가장 잘 맞는 것을 선택하세요.

FAQ

Suno + WorkBuddy 질문

WorkBuddy 일반 설정

아직 연결하지 않으셨나요? WorkBuddy용 RunAPI MCP 설정 가이드를 참조하세요.

WorkBuddy 설정 가이드 →

Suno 모델 카탈로그

모든 Suno 버전, 가격 및 사용 가능한 endpoint를 확인하세요.

RunAPI에서 Suno 보기 →

지금 WorkBuddy에서 Suno를 사용해 보세요.

무료 RunAPI 키를 발급받고, WorkBuddy에 MCP 서버를 추가한 후, 노래를 설명하면 워크벤치 에이전트가 보컬, 악기, 믹싱이 포함된 완성된 트랙을 반환합니다.

모델 보기 →