auto_lyrics, exact_lyrics, instrumental의 차이점은 무엇인가요?

auto_lyrics는 프롬프트로 가사를 생성합니다 — 노래를 설명하면 Suno가 가사를 작성합니다. exact_lyrics는 직접 제공한 가사를 그대로 사용하며 style과 title 필드가 필요합니다. instrumental은 보컬 없이 style과 title만으로 트랙을 만듭니다.

Hermes Agent에서 Suno용으로 RunAPI를 커스텀 공급자로 설정하는 방법은?

Hermes Agent 설정에서 base_url을 https://runapi.ai/v1으로, api_key를 RUNAPI_API_KEY에서 읽도록 custom:runapi 공급자를 추가하세요. 동일한 공급자가 채팅, 이미지, 영상, 음악 엔드포인트를 모두 처리하며 Suno를 위한 별도 설정이 필요하지 않습니다.

RunAPI가 공식 Suno API를 제공하나요?

Suno는 공개 API를 제공하지 않습니다. RunAPI는 다른 모든 RunAPI 모델과 동일한 API key와 작업 생명주기를 통해 Suno v4~v5.5에 프로그래밍 방식의 접근을 제공합니다. Suno 계정이나 별도 인증 정보가 필요하지 않습니다.

보컬 없이 악기만으로 트랙을 생성할 수 있나요?

네. vocal_mode를 instrumental로 설정하고 style과 title 필드를 제공하세요. instrumental 모드에서는 prompt와 lyrics 필드를 생략해야 합니다. API가 이 크로스 필드 규칙을 강제하며 충돌하는 필드가 전송되면 유효성 검사 오류를 반환합니다.

text_to_music 외에 사용 가능한 다른 Suno 엔드포인트는 무엇인가요?

RunAPI는 cover_audio(기존 트랙 스타일 변경), extend_music(타임스탬프부터 노래 계속), create_mashup(여러 트랙 요소 결합), text_to_sound(효과음), 그리고 generate_lyrics, generate_persona, separate_audio_stems 등 유틸리티 엔드포인트를 제공합니다. 모두 동일한 API key와 작업 생명주기를 공유합니다.

HERMES + SUNO

Hermes Agent에서 Suno를 사용하세요.

Suno는 텍스트 프롬프트나 직접 작성한 가사로 보컬, 악기, 믹싱이 포함된 완성된 노래를 생성합니다. RunAPI를 통해 v4~v5.5 버전을 이용할 수 있으며, Suno의 공식 공개 API가 없기 때문에 RunAPI가 API 접근을 제공합니다. Hermes Agent는 채팅에 사용하는 것과 동일한 API key로 custom:runapi 공급자를 통해 호출합니다.

API Key 받기 문서 읽기

하나의 API key · 텍스트-음악 엔드포인트 · 비동기 작업 폴링

Use RunAPI to generate a song with Suno.

Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- Call POST https://runapi.ai/api/v1/suno/text_to_music
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" for AI-generated lyrics from a prompt.
- Set prompt to describe the song you want.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.

curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5.5",
    "vocal_mode": "auto_lyrics",
    "prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
    "vocal_gender": "female"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

curl 명령어를 복사하여 테스트하세요 suno

작동 방식

Hermes Agent에서 Suno를 세 단계로 사용하기

RunAPI 설정

Hermes Agent가 실행되는 환경에 RUNAPI_API_KEY를 설정하세요. 이미 RunAPI를 custom:runapi 공급자로 추가했다면 동일한 key와 base_url로 Suno 음악 요청도 처리됩니다.

export RUNAPI_API_KEY=runapi_xxx

text_to_music 호출

model과 vocal_mode를 포함하여 text_to_music 엔드포인트로 POST 요청을 보내세요. AI 가사 생성에는 prompt와 함께 auto_lyrics를, 직접 작성한 가사에는 lyrics/style/title과 함께 exact_lyrics를, 보컬 없는 트랙에는 style/title과 함께 instrumental을 사용하세요.

POST /api/v1/suno/text_to_music

결과 가져오기

엔드포인트는 즉시 task_id를 반환합니다. 노래 생성은 버전에 따라 30초에서 수 분이 소요됩니다. 상태가 completed가 될 때까지 작업 상태 엔드포인트를 폴링한 후 오디오 URL을 읽으세요.

GET /api/v1/suno/text_to_music/tsk_abc123

파라미터

Suno text_to_music API 파라미터

파라미터	유형	설명
`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(lyrics/style/title 직접 제공), 또는 instrumental(보컬 없음, style/title 필요).
`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 모드에서 필수.
`title`	`string`	노래 제목. exact_lyrics 및 instrumental 모드에서 필수.
`vocal_gender`	`string`	선택 사항. male 또는 female.
`negative_tags`	`string`	선택 사항. 피하고 싶은 스타일 (예: heavy metal, screaming).
`duration_seconds`	`integer`	선택 사항. 목표 재생 시간(초).
`persona_id`	`string`	선택 사항. 커스텀 음성 또는 스타일 프로필의 Persona ID.
`persona_type`	`string`	선택 사항. style 또는 voice. 페르소나 카테고리를 선택합니다.
`callback_url`	`string`	선택 사항. 작업 완료 시 POST를 수신할 웹훅 URL.

Hermes Agent의 Suno란?

Suno는 텍스트 설명이나 가사에서 보컬·악기·믹싱이 포함된 완전한 노래를 생성하는 텍스트→음악 생성기입니다. Hermes Agent는 custom:runapi provider를 통해 호출하며, 멀티 스텝 콘텐츠 워크플로에 적합합니다——Kling으로 동영상을 생성한 후 Suno로 매칭되는 오리지널 사운드트랙을 만들어 단일 agent 실행으로 완성합니다.

Suno 활용 사례

스튜디오 제작 전 작곡 스케치

노래 컨셉——장르·분위기·템포·주제——을 설명하면 완전한 데모 트랙을 받습니다. 스튜디오 시간을 쓰기 전에 아이디어를 빠르게 반복하며 다른 스타일과 편곡이 어떻게 들리는지 확인합니다.

새 스타일로 AI 커버

cover_audio 엔드포인트로 기존 트랙을 새롭게 편곡합니다. 핵심 멜로디와 구조를 유지하면서 장르를 바꾸고 악기를 교체하거나 분위기를 전환합니다.

완전한 시청각 콘텐츠 파이프라인

Hermes Agent 워크플로에서 동영상 모델과 Suno를 연결합니다——동영상 영상을 생성한 후 매칭되는 오리지널 사운드트랙을 만들어 별도의 음악 라이선스 없이 바로 게시 가능한 콘텐츠를 제작합니다.

FAQ

Suno + Hermes Agent 자주 묻는 질문

Hermes Agent 일반 설정

아직 설정하지 않으셨나요? Hermes Agent용 RunAPI 설정 가이드로 시작하세요.

Hermes Agent 설정 가이드 →

Suno 모델 카탈로그

Suno의 모든 버전, 가격, 사용 가능한 엔드포인트를 확인하세요.

RunAPI의 Suno →

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

무료 RunAPI key를 발급받고, custom:runapi 공급자를 설정하여 텍스트 설명으로 보컬, 악기, 믹싱이 포함된 완성된 노래를 생성하세요.

모델 보기 →