Suno · 오디오 & 음악

OpenClaw x Suno

Suno는 텍스트 설명으로부터 보컬, 악기, 가사를 포함한 오리지널 노래를 만드는 AI 음악 생성 플랫폼입니다. RunAPI를 통해 모든 Suno 버전은 단일 API 키와 호출별 과금 방식을 공유합니다.

9 variants 최저 $0.01 / 회 상업적 사용 지원
API 키 받기 OpenClaw 문서 보기

Prerequisite: npx runapi mcp install

Prompt

프롬프트 모델

작업에 맞는 경우 suno-v4를 사용하세요: 향상된 일관성과 주파수 범위, 4분 제한.

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: 향상된 일관성과 주파수 범위, 4분 제한
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_samples, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: 8분 최초 생성, 장르 오류 25% 감소, 보컬 40% 향상
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/create_mashup, /api/v1/suno/extend_music, /api/v1/suno/add_samples, /api/v1/suno/stitch_audio, /api/v1/suno/inspire_music, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: 구독 제한 없이 모든 v4.5 스타일과 모드 사용 가능
  endpoints: /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-plus: v4.5 아키텍처 내 향상된 품질 티어
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: CD 품질 오디오, 생성당 최대 8분
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/add_instrumental, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: 생성당 최대 8분, 음성 복제 및 스타일 학습
  endpoints: /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: 부드러운 피아노, 바이닐 스크래치 소리, 잔잔한 베이스 라인이 있는 2분짜리 lo-fi 칠 비트를 작성해 주세요.
/api/v1/suno/stitch_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/stitch_audio를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/stitch_audio/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/extend_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/extend_music를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/extend_music/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/create_mashup: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/create_mashup를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/create_mashup/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/add_samples: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_samples를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/add_samples/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/cover_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/cover_audio를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/cover_audio/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/inspire_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/inspire_music를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/inspire_music/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/text_to_music: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/text_to_music를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/text_to_music/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/remaster_audio: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/remaster_audio를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/remaster_audio/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/add_instrumental: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_instrumental를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/add_instrumental/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/add_vocals: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/add_vocals를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/add_vocals/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.
/api/v1/suno/text_to_sound: Submit the task, poll for its status, then verify the completed output. POST /api/v1/suno/text_to_sound를 실행하고 반환된 Task ID를 저장합니다.
상태가 completed 또는 failed가 될 때까지 GET /api/v1/suno/text_to_sound/<task-id>를 실행합니다.
completed 응답에 API 레퍼런스의 엔드포인트별 출력이 포함되는지 확인합니다.

공개 버전 및 엔드포인트

Suno V6가 출시되었습니다. 이전 모델 ID(v3.5–v5.5)를 사용하는 요청은 자동으로 V6 또는 V6 Mini로 라우팅됩니다. 가격은 변동 없습니다.
모델 ID 엔드포인트 시작 가격 모델 카탈로그
suno-v4
/api/v1/suno/stitch_audio /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_samples /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/remaster_audio
$0.01 / 회 모델 상세
suno-v4.5
/api/v1/suno/remaster_audio /api/v1/suno/create_mashup /api/v1/suno/extend_music /api/v1/suno/add_samples /api/v1/suno/stitch_audio /api/v1/suno/inspire_music /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.01 / 회 모델 상세
suno-v4.5-all
/api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.12 / 회 모델 상세
suno-v4.5-plus
/api/v1/suno/cover_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.01 / 회 모델 상세
suno-v5
/api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/add_instrumental /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/add_vocals
$0.01 / 회 모델 상세
suno-v5.5
/api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/remaster_audio
$0.01 / 회 모델 상세
suno-v6
/api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/extend_music
$0.12 / 회 모델 상세
suno-v6-mini
/api/v1/suno/cover_audio /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / 회 모델 상세
suno-v6-wild
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / 회 모델 상세

검증

Task가 최종 상태에 도달할 때까지 폴링합니다

<model-id>를 선택하면 검증 명령을 생성합니다.

설정

가이드 엔드포인트: <endpoint>

<model-id>를 선택하면 엔드포인트의 공개 입력 계약에 맞는 요청을 생성합니다.

추가 작업

이 작업들은 모델 ID를 사용하지 않습니다.

  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/generate_artwork
  • /api/v1/suno/generate_persona
  • /api/v1/suno/generate_midi
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_voice
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/voice_to_validation_phrase
  • /api/v1/suno/convert_audio
  • /api/v1/suno/visualize_music
  • /api/v1/suno/generate_lyrics
  • /api/v1/suno/blend_lyrics
  • /api/v1/suno/replace_section
사용 절차

3단계로 시작하기

  1. 모델 ID 선택

    공개 모델 ID를 선택하고 엔드포인트와 현재 시작 가격을 확인합니다.

  2. RunAPI 설정

    엔드포인트 요청 전에 RUNAPI_API_KEY를 설정합니다.

  3. 결과 검증

    비동기 엔드포인트는 Task가 최종 상태가 될 때까지 같은 엔드포인트를 폴링합니다.

OpenClaw + Suno로 만들 수 있는 것

  • YouTube와 소셜 미디어 배경 음악

    프롬프트에 분위기와 장르를 설명해 영상용 오리지널 배경 음악을 생성합니다.

  • 가사를 완성된 곡으로 듣기

    작사가는 가사와 스타일 설명을 제공해 스튜디오 작업 전에 노래로 완성된 데모를 들어볼 수 있습니다.

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

    팟캐스트의 분위기에 맞는 연주곡 인트로와 아웃트로를 만들고, 여러 버전 중 가장 잘 맞는 것을 고릅니다.

Suno을(를) RunAPI + OpenClaw로 사용하는 이유

  • 9개 변형 모델, 하나의 API 키

    하나의 RunAPI 연결에서 사용 가능한 모델 변형을 선택할 수 있어 통합 방식을 바꿀 필요가 없습니다.

  • 명확한 사용 요금

    요청을 보내기 전에 현재 카탈로그 요금을 확인하세요. 구독이나 최소 사용 금액이 없습니다.

  • 자동화된 작업 워크플로

    수동 폴링 코드를 작성하지 않고 일관된 작업 흐름으로 비동기 결과를 제출하고 확인하고 수집하세요.

OpenClaw + Suno 자주 묻는 질문

Suno 프롬프트를 더 잘 쓰려면 어떻게 하나요?

장르, 분위기, 템포, 악기 구성을 구체적으로 적으세요. "어쿠스틱 기타와 따뜻한 신스가 있는 경쾌한 인디 팝" 같은 프롬프트가 "신나는 노래"보다 좋은 결과를 냅니다.

Suno 곡을 첫 클립 이후로 더 길게 만들 수 있나요?

네. RunAPI의 Suno는 곡 연장, 커버 생성, 곡 결합 엔드포인트를 제공하며, 모두 같은 API 키와 작업 흐름으로 사용합니다.

RunAPI로 Suno를 쓰려면 Suno 계정이 필요한가요?

아니요. RunAPI는 RunAPI API 키와 잔액으로 Suno에 대한 프로그래밍 방식의 접근을 제공합니다. Suno 계정이나 별도의 자격 증명은 필요 없습니다.

어떤 모델 ID를 사용해야 하나요?

버전 표에서 공개 모델 ID를 선택하세요. 각 ID가 제공하는 엔드포인트는 해당 행에 표시됩니다.

이 가이드는 채팅 모델을 설정하나요?

아니요. 이 Model Line은 여기에 표시된 엔드포인트 절차를 사용하며 Agent 채팅 모델로 제공되지 않습니다.

OpenClaw에서 Suno 사용 시작하기

API 키 받기 빠른 시작 읽기

팀과 함께 구축하고 계신가요?

엔터프라이즈 설정, 통합, 기술 문의를 도와드립니다.

문의하기