소개
SpicyAPI의 Suno v6는 요청 한 번에 완성된 노래 두 버전을 돌려주는 텍스트 투 뮤직 작업입니다. 각각 보컬과 반주가 담긴 완전한 MP3입니다. prompt에 스타일을 적고, 부를 가사가 있다면 lyrics에 함께 보내세요. Suno는 v6를 신뢰할 수 있고 정밀한 모델이라고 소개하며, 저희 테스트에서도 가사가 순서대로 한 마디씩 그대로 불렸습니다. 요청 전체에 정액 요금이 적용됩니다.
핵심 기능 및 하이라이트
매번 두 가지 테이크
요청마다 완성된 노래 두 버전이 반환됩니다. 한쪽이 다른 쪽의 일부를 잘라 낸 것이 아니라 편곡도 길이도 다를 수 있으므로, 마음에 드는 쪽을 남기면 됩니다. 정액 요금에 두 버전이 모두 포함됩니다.
쓴 그대로 불리는 가사
11줄짜리 가사가 쓴 순서대로 한 줄씩 불려 돌아왔습니다. [Verse], [Chorus] 같은 섹션 태그는 불리지 않은 채 구조만 잡아 주었고, 후렴은 가사에서 반복하지 않는 한 반복되지 않았습니다.
가사를 다루는 세 가지 방법
직접 쓴 가사를 가져오거나, prompt를 바탕으로 모델이 쓰게 하거나(generate_lyrics는 기본값이 켜짐), instrumental을 켜서 보컬을 없앨 수 있습니다. title, vocal_gender, style_weight, weirdness, variety, 페르소나 같은 세부 조정은 직접 쓴 가사를 쓰거나 연주곡일 때 적용됩니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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초, 가사를 가득 채우면 2분이 넘는 곡이 나왔습니다.
이미지나 영상을 따라가는 음악
가사 자동 생성 모드에서는 무드 이미지 최대 5장, 참고 영상 1개, 또는 참고 오디오 1개를 보내면 모델이 이를 바탕으로 노래를 씁니다. 가사 없는 배경음악이 필요하면 instrumental을 켜세요.
프롬프트 가이드 및 실전 팁
아티스트가 아니라 사운드를 설명하세요
장르, bpm으로 나타낸 템포, 두세 가지 악기, 목소리 종류를 적습니다. 예: ‘soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano’. 실제 아티스트 이름이 들어간 프롬프트는 거부되므로 사운드를 말로 설명하세요.
섹션에 태그 달기
[Intro], [Verse], [Chorus], [Bridge], [Outro]를 단독 행에 두고, 후렴이 돌아오길 원하는 위치에는 후렴 가사를 다시 적으세요. 줄이 많을수록 노래가 길어지며, 길이 설정은 없습니다.
필터가 막는 것을 알아 두세요
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/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 레퍼런스에서 확인하세요.
