PopNowAPI 문서
본문

Suno v6 Mini API 레퍼런스

한 문장으로 보컬 있는 곡 두 개를 빠르게

PopNow API 키 하나로 내 코드에서 Suno v6 Mini을(를) 호출할 수 있습니다. 보낼 모델 ID, 이 모델이 받는 모든 입력 필드, 요청 한 번에 드는 크레딧, 터미널에 붙여 넣으면 바로 실행되는 요청을 정리했습니다.

파라미터 설명은 모델의 입력 schema에서 가져오므로 영어로만 제공됩니다.

한눈에 보기

제작사
Suno
결과물
오디오
최저가
10.8크레딧 요청 1회당 ($0.108)
모델 ID

1크레딧 = 0.01달러. 작업이 접수되면 가능한 최대 금액을 먼저 잡아 두고, 끝나면 실제 사용량으로 정산합니다(정수 크레딧으로 올림, 남는 금액은 반환). 실패한 작업에는 과금하지 않습니다. 실행 전에 정확한 금액이 궁금하면 POST /api/v1/jobs/quote를 호출하세요.

음악

suno/v6-mini/text-to-audio

요금

옵션크레딧 (요청 1회당)미국 달러
기본10.8$0.108

파라미터

필드타입기본값허용 값설명
prompt필수string—최대 3,000자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.
lyrics선택string—최대 5,000자Words to sing, sung in order. Section tags such as [Verse], [Chorus] and [Bridge] shape the song and are not sung.
generate_lyrics선택booleantrue—Let the model write the lyrics from the prompt. Only applies when lyrics is empty and instrumental is off.
instrumental선택booleanfalse—Generate music with no vocals.
title선택string—최대 80자Song title (metadata, not sung). Applies with lyrics or an instrumental; otherwise the model names the song.
negative_prompt선택string—최대 500자Styles or elements to keep out of the song.
vocal_gender선택string—female, maleMake a female or male lead vocal more likely. Applies with lyrics.
style_weight선택number—0~1How closely to follow the style in the prompt, from 0 to 1.
weirdness선택number—0~1How experimental the song may get, from 0 (conventional) to 1 (unusual).
audio_weight선택number—0~1How strongly a persona's audio shapes the result, from 0 to 1. Songs with vocals only.
variety선택integer—0~4How different the two versions are from each other: 0 off, 1 normal (the model default), 2 high, 3 extra, 4 max.
persona_id선택string—최대 200자ID of an existing Suno persona to reuse its style or voice.
persona_model선택string—style_persona, voice_personaWhether persona_id is a style persona or a voice persona.
image_urls선택array<string (uri)>—최대 5개Up to 5 mood images (JPEG, PNG or WebP, 10 MB each). Only when the model writes the lyrics.
reference_video_urls선택array<string (uri)>—최대 1개One reference video (MP4 or WebM, up to 100 MB and 241 seconds). Only when the model writes the lyrics.
reference_audio_urls선택array<string (uri)>—최대 1개One reference audio clip (MP3 or WAV, 6 seconds to 30 minutes). Only when the model writes the lyrics.

요청 예제

이 요청은 그대로 실행됩니다. 빠진 필드는 기본값을 씁니다. 먼저 키를 환경 변수 POPNOW_API_KEY에 넣어 두세요.

POST /api/v1/jobs/createTask
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: $(uuidgen)" \
  -d '{
  "model": "suno/v6-mini/text-to-audio",
  "input": {
    "prompt": "An upbeat indie pop song about a summer road trip, bright guitars, hand claps and a catchy whistled hook"
  }
}'

응답에는 taskId가 바로 들어 있습니다. 결과는 GET /api/v1/jobs/recordInfo로 가져오거나, callBackUrl을 넣어 알림을 받으세요.

GET /api/v1/jobs/recordInfo
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

다음 단계

이 페이지에서

한눈에 보기음악다음 단계