API 키 받기

Suno

가사나 짧은 설명으로 보컬이 들어간 완곡

suno/v6/text-to-audio11크레딧부터/회 · US$0.11
  • 참조 이미지 최대 5장
  • 직접 쓴 가사
  • 음악
예시 보기

Suno v6 소개

Suno의 플래그십 v6 모델을 API로. 직접 쓴 가사나 한 줄 아이디어를 넣고 스타일을 설명하면, 보컬이 담긴 완성곡 두 곡 또는 연주곡이 요청 한 번에 돌아옵니다. 길이와 상관없이 정액 요금입니다.

POST /jobs/createTask에서 모델 이름을 suno/v6/text-to-audio(으)로 지정하면 호출할 수 있습니다. 11크레딧/회부터(US$0.11). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
audio_weight아니요How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only. ≥ 0 · ≤ 1
generate_lyrics아니요Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off. 기본값: true
image_urls아니요분위기를 정하는 이미지. 음악이 그 느낌을 따라갑니다.
instrumental아니요보컬 없이 음악만. 기본값: false
lyrics아니요가사를 직접 쓰거나 모델에 맡깁니다.
negative_prompt아니요곡에 넣고 싶지 않은 스타일이나 소리.
persona_id아니요ID of an existing Suno persona to reuse its style or voice.
persona_model아니요Whether persona_id is a style persona or a voice persona. style_persona · voice_persona
prompt예Describe the song: genre, mood, tempo, instruments and voice. With lyrics or an instrumental this is the style (up to 1,000 characters); with no lyrics the model writes the words from it.
reference_audio_urls아니요맞출 소리: 목소리, 음악, 리듬.
reference_video_urls아니요음악을 맞출 영상.
style_weight아니요How closely to follow the style in the prompt, from 0 to 1. ≥ 0 · ≤ 1
title아니요Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song.
variety아니요How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max. ≥ 0 · ≤ 4
vocal_gender아니요Make a female or male lead vocal more likely. Applies with lyrics. female · male
weirdness아니요How experimental the song may get, from 0 (conventional) to 1 (unusual). ≥ 0 · ≤ 1

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /회≈ USD
기본10.8US$0.11

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 11크레딧/회(US$0.11)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Suno v6 API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 suno/v6/text-to-audio, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "suno/v6/text-to-audio",
  "input": {
    "prompt": "Calm ambient pads with a slow rising motif"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Suno v6 API 질문

Suno v6 API 요금은 얼마인가요?

Suno v6 가격은 11크레딧(US$0.11) /회입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Suno v6의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 음악: suno/v6/text-to-audio을(를) 넣으세요.

Suno는 v6에 대해 무엇이라고 설명하나요?

Suno는 v6가 신뢰할 수 있고 정밀하며 모든 장르와 스타일에서 일관되게 완성도 높은 음악을 만들어 내는 모델이라고 설명합니다. 2026년 9월 9일에 v6 Wild, v6 Mini와 함께 출시되었습니다.

가사를 정확히 그대로 불러 주나요?

저희 테스트에서는 기본 설정에서 그랬습니다. 11줄짜리 가사가 쓴 순서대로 한 마디씩 그대로 불렸습니다. [Chorus] 같은 섹션 태그는 불리지 않았고, 후렴이 제멋대로 반복되지도 않았습니다.

요청이 거부되거나 실패하면 요금이 청구되나요?

아니요. 해당 요청을 위해 확보해 둔 금액은 전액 해제됩니다.

누가 노래할지 고를 수 있나요?

일부는 가능합니다. 스타일 설명에 자신감 있는 여성 리드처럼 목소리를 적어 주세요. 직접 쓴 가사를 쓰거나 instrumental을 켠 경우에는 vocal_gender를 female 또는 male로 지정할 수도 있지만, 이는 보장이 아니라 선호 설정이며 얼마나 지켜지는지는 측정하지 않았습니다. 한 문장 아이디어로 듀엣을 요청했을 때 저희 테스트에서는 솔로로 돌아왔으니, 중요하다면 목소리를 하나로 지정하세요.

Suno v6 API의 제한은 무엇인가요?

참조 이미지: 5; 참조 오디오: 1; 참조 영상: 1; 프롬프트 길이(글자): 3,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 Suno v6을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 Suno v6을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

모든 Suno 모델

이미 머릿속에 있는 곡을 만들 때는 Suno v6이 가장 믿을 만해요. v6 Wild는 더 의외의 질감 있는 전개를 보여 주고, v6 Mini는 빠르게 스케치하기 좋아요. 세 가지 모두 한 번 실행하는 가격이 같아요.

Suno v6 더 알아보기