소개
SpicyAPI의 Suno v6 Mini는 요청 한 번에 완성된 노래 두 버전을 돌려주는 텍스트 투 뮤직 작업입니다. Suno는 이를 아이디어를 노래로 만들기 쉽게 해 주는, v6의 더 빠르고 효율적인 버전이라고 설명합니다. prompt에 스타일 설명을, 원하면 직접 쓴 lyrics를 보내면 MP3 두 개가 돌아옵니다. 여기서는 v6, v6 Wild와 같은 정액 요금입니다.
핵심 기능 및 하이라이트
아이디어를 넣으면 노래가 나옵니다
문장 하나를 쓰고 lyrics는 비워 두세요. generate_lyrics가 켜져 있으면(기본값) 모델이 가사를 쓰고 직접 부릅니다. 저희 테스트에서는 약 3분 30초 분량의 가사를 썼고 모든 줄을 순서대로 불렀습니다.
같은 가사 처리
직접 쓴 가사를 가져오면 v6 Mini는 쓴 그대로 부릅니다. 세 모델 모두에 사용한 11줄짜리 가사가 한 마디씩 순서대로 돌아왔고, [Verse]와 [Chorus] 태그는 불리지 않았습니다.
두 가지 테이크
요청마다 두 버전이 반환되며 길이가 다를 수 있습니다. 정액 요금에 두 버전이 모두 포함되므로, 빠른 초안은 곡이 얼마나 길어지든 같은 요금입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 스타일 설명입니다. 직접 쓴 lyrics를 쓰거나 instrumental을 켠 경우에는 장르, 템포, 악기, 목소리, 분위기 같은 스타일만 최대 1,000자까지 적습니다. 1자 이상 · 3000자 이하 |
lyrics | 아니요 | 부를 가사로, 최대 5,000자이며 한 줄에 한 행씩 씁니다. [Verse], [Chorus], [Bridge], [Outro] 같은 섹션 태그를 단독 행에 두면 곡 구조가 잡히며, 태그 자체는 불리지 않습니다. 1자 이상 · 5000자 이하 |
generate_lyrics | 아니요 | 기본값은 켜짐입니다. lyrics가 비어 있고 instrumental이 꺼져 있으면 모델이 prompt를 바탕으로 가사를 씁니다. 기본값: |
instrumental | 아니요 | 보컬 없는 트랙을 만들려면 켭니다. 이때 prompt는 스타일 설명(최대 1,000자)이 되며 lyrics는 필요 없습니다. 기본값: |
title | 아니요 | 곡 제목으로, 최대 80자입니다. 직접 쓴 lyrics를 쓰거나 instrumental을 켠 경우에 적용되며, 가사를 자동 생성할 때는 모델이 제목을 정합니다. 1자 이상 · 80자 이하 |
negative_prompt | 아니요 | 곡에서 빼고 싶은 스타일, 소리, 분위기를 쉼표로 구분한 짧은 목록으로 적습니다. 예: ‘harsh distortion, spoken word’. 1자 이상 · 500자 이하 |
vocal_gender | 아니요 | 리드 보컬을 여성(female) 또는 남성(male) 쪽으로 유도합니다. 보장이 아니라 선호 설정이며, 얼마나 지켜지는지는 테스트하지 않았습니다. |
style_weight | 아니요 | 곡이 스타일 설명을 얼마나 엄격하게 따를지를 0에서 1까지 0.01 단위로 지정합니다. 직접 쓴 lyrics를 쓰거나 instrumental을 켠 경우에만 적용되며, 그 밖의 경우에는 알기 쉬운 오류가 반환됩니다. |
weirdness | 아니요 | 곡이 예상에서 얼마나 벗어나도 되는지를 0(보편적)에서 1(모험적)까지 0.01 단위로 지정합니다. 직접 쓴 lyrics를 쓰거나 instrumental을 켠 경우에만 적용됩니다. |
audio_weight | 아니요 | 입력한 오디오가 결과에 얼마나 강하게 반영되는지를 0에서 1까지 0.01 단위로 지정합니다. Suno는 보컬 없는 곡에서는 이를 지원하지 않습니다. |
variety | 아니요 | 모델이 스타일 프롬프트를 얼마나 변주할지를 0(꺼짐: 스타일 태그를 쓴 그대로 사용)에서 4(최대)까지의 정수로 지정합니다. 기본값은 1입니다. |
persona_id | 아니요 | 곡을 부르거나 연주할, 저장해 둔 Suno 페르소나(보이스)의 ID입니다. 선택 사항입니다. 1자 이상 · 200자 이하 |
persona_model | 아니요 | persona_id가 무엇인지 모델에 알려 줍니다. |
image_urls | 아니요 | 곡의 분위기를 잡는 데 참고할 무드 이미지를 최대 5장까지 지정할 수 있습니다(JPEG, PNG, WebP, BMP, 각 10MB 이하). 가사 자동 생성 모드에서만 사용할 수 있습니다(lyrics 없음, instrumental 꺼짐, |
reference_video_urls | 아니요 | 곡의 기준이 될 참고 영상 1개를 지정할 수 있습니다(MP4, MOV, WebM, 100MB 및 241초 이하). 예를 들어 영상에 음악을 입히고 싶을 때 사용합니다. 1개 이하 |
reference_audio_urls | 아니요 | 곡에 영감을 줄 참고 오디오 파일 1개를 지정할 수 있습니다(6초~30분, 500MB 이하). 가사 자동 생성 모드에서만 사용할 수 있습니다(lyrics 없음, instrumental 꺼짐, |
요금
$0.072 / 요청
요청당 정액 요금이며, 곡 길이와 관계없이 두 버전이 모두 포함됩니다.
활용 사례
노래를 빠르게 스케치하기
노트처럼 쓰세요. 후크를 입력하고, 들어 보고, 다시 쓰는 겁니다. 짧은 가사로는 약 1분 30초 길이의 곡이 나옵니다.
부드러운 어쿠스틱과 라운지 스타일
저희 샘플로 생성한 것은 몇 가지 악기를 지정한 포크, 인디, 재즈 요청으로, 핑거피킹 포크송에서 스모키한 라운지 연주곡까지입니다.
프롬프트 가이드 및 실전 팁
요청은 짧고 구체적으로
장르, bpm으로 나타낸 템포, 두세 가지 악기를 적습니다. 예: ‘acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar’. 실제 아티스트 이름은 거부됩니다.
먼저 쓰게 한 뒤 이어받기
아이디어로 시작해 모델이 고른 가사를 읽어 보세요. 마음에 드는 부분을 lyrics에 복사해 고친 뒤 다시 실행하면 쓴 그대로 불립니다.
필터가 막는 것을 알아 두세요
Suno는 약함 단계를 넘는 가사와 설명을 몇 초 만에 과금 없이 거절합니다. 약함 단계의 가사와 강한 표현은 노래로 불렸습니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6-mini/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
