OPENCLAW + SUNO

OpenClaw에서 Suno를 사용하세요.

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

API Key 받기 문서 읽기
하나의 API key · 텍스트-음악 엔드포인트 · 비동기 작업 폴링 
Use RunAPI to generate a song with Suno.

Requirements:
- Read the API key from RUNAPI_API_KEY.
- 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
작동 방식

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

1

RunAPI 설정

환경 변수에 RUNAPI_API_KEY를 설정하세요. 채팅용으로 이미 OpenClaw에 RunAPI를 설정했다면, 동일한 key로 Suno 음악 생성도 가능합니다 — 별도 공급자 설정 불필요.

export RUNAPI_API_KEY=runapi_xxx
2

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
3

결과 가져오기

엔드포인트는 즉시 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.

OpenClaw의 Suno란?

Suno는 텍스트 프롬프트 또는 가사에서 보컬·악기·믹싱이 포함된 완전한 노래를 생성하는 텍스트→음악 AI입니다. OpenClaw agent는 RunAPI를 통해 호출합니다——Suno에는 공식 퍼블릭 API가 없어 RunAPI를 통해 v4부터 v5.5까지에 프로그래밍 방식으로 접근할 수 있습니다.

Suno 활용 사례

YouTube 및 소셜 미디어 배경 음악

분위기와 장르를 프롬프트로 설명해 동영상용 오리지널 배경 음악을 생성합니다. 라이선스 비용도, 저작권 문제도 없습니다——트랙은 콘텐츠를 위해 새로 생성됩니다.

가사를 완전한 노래로 듣기

작사가가 exact_lyrics 모드에 가사와 스타일 설명을 붙여 넣으면 완전한 노래로 연주된 버전을 들을 수 있어, 스튜디오 시간 전에 제작 데모를 얻을 수 있습니다.

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

장르·분위기·길이를 지정해 팟캐스트 톤에 맞는 순수 악기 인트로와 아웃트로를 제작합니다. 여러 버전을 생성해 가장 잘 맞는 것을 선택합니다.

FAQ

Suno + OpenClaw 자주 묻는 질문

OpenClaw 일반 설정

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

OpenClaw 설정 가이드 →

Suno 모델 카탈로그

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

RunAPI의 Suno →

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

무료 RunAPI key를 발급받고, 프롬프트를 OpenClaw에 붙여넣어 텍스트 설명으로 보컬, 악기, 믹싱이 포함된 완성된 노래를 생성하세요.

모델 보기 →