Suno API 문서 — 프롬프트로 음악 생성(V5 / V5.5) 및 가격

Suno는 동급 최고 수준의 AI 음악 모델로, 텍스트 프롬프트에서 보컬, 가사, 악기가 포함된 완성곡을 생성합니다. Kunavo의 Suno API(Suno V5 및 V5.5)는 POST /v1/audio/music를 통해 이를 프로그래밍 방식으로 수행하고, 하나의 bearer token으로 호스팅된 오디오 트랙을 반환합니다. 이 문서는 실제 사용에 필요한 요청 형식, 가격 및 프로덕션용 비동기 패턴을 다룹니다.

Suno API 호출

/app/keys에서 키를 생성하고 프롬프트를 POST하세요. 한 번의 요청으로 약 두 가지 트랙 변형이 반환되며, 생성에는 수십 초에서 몇 분이 걸립니다:

import requests

# Music generation is a POST to /v1/audio/music. One request returns
# ~2 track variations; generation takes tens of seconds to a couple of minutes.
resp = requests.post(
    "https://api.kunavo.com/v1/audio/music",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "suno-v5",                 # or suno-v5-5
        "prompt": "uplifting lo-fi hip hop with mellow piano and vinyl crackle",
        "instrumental": False,              # set True to skip vocals
    },
    timeout=300,
)
for track in resp.json()["data"]:
    print(track["url"])

전체 매개변수와 비동기 작업 수명 주기는 음악 API 참조에 나와 있습니다.

가격

Suno는 생성 요청당 청구되며 트랙당 청구되지 않습니다. 따라서 반환되는 약 2개의 변형에 한 번의 요금이 부과됩니다. 최신 요금은 각 모델 페이지에서 확인할 수 있습니다. Suno 자체는 요청당 API 가격을 공개하지 않습니다. 자체 API는 공개 요금이 없는 파트너 전용 프로그램이므로 표에는 Kunavo가 청구하는 금액만 표시됩니다.

$10 최소 충전부터 종량제로 이용할 수 있고 잔액은 만료되지 않으며 실패한 생성에는 요금이 부과되지 않습니다. 더 넓은 작업량은 비용 계산기로 추정하세요.

사용자 지정 모드: 직접 작성한 가사

일반 프롬프트 대신 lyrics, style 설명 및 title를 제공해 세부적으로 제어하거나, 보컬을 완전히 제외하려면 instrumental: true를 설정하세요:

# Custom mode: supply your own lyrics + a style, instead of a plain prompt.
curl https://api.kunavo.com/v1/audio/music \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5-5",
    "lyrics": "[Verse]\nCity lights blur into the rain...",
    "style": "synthwave, 110 bpm, female vocal",
    "title": "Neon Rain"
  }'

프로덕션에서는 비동기 방식

음악 생성은 즉시 완료되지 않으므로 대규모 환경에서는 연결을 붙잡아 두지 말고 작업을 제출한 뒤 결과를 폴링하세요. 작업 수명 주기, 폴링 및 웹훅 전달은 음악 문서에서 설명합니다. 결과 URL은 완료되면 영구적으로 유지됩니다.

Kunavo와 Suno 직접 이용 비교

Suno 자체 제품은 사용량이 측정되는 종량제 API가 아니라 크레딧이 포함된 구독입니다. 이것이 바로 개발자들이 처음부터 "Suno API"를 찾게 되는 이유입니다:

제품 안에서 음악을 생성한다면 측정형 결제와 실제 엔드포인트가 핵심입니다. 사람이 브라우저에서 직접 트랙을 만들기만 한다면 Suno 자체 구독이 더 간단한 선택입니다.

Suno API와 Udio API 비교

Udio는 또 다른 주요 음악 생성 제품군이며 "Udio API"도 흔히 함께 검색됩니다. 현재 실질적인 차이는 Udio API 접근이 안정적인 공개 가격 없이 실험적인 타사 경로를 통해 제공되는 반면, Kunavo의 Suno V5 / V5.5는 정액 공개 요금($0.09 생성 요청당)의 지원 엔드포인트라는 점입니다. 프로덕션에서 안정적인 음악 생성이 필요하다면 여기의 Suno V5 API가 신뢰할 수 있는 경로입니다. 안정적인 상위 공급자가 생기면 Udio도 평가하겠습니다.

음악을 넘어

동일한 키로 텍스트(Claude, GPT), 이미지(Nano Banana, GPT-Image-2), 비디오(Veo 3, Seedance 2, Wan 2.7)에 접근할 수 있으므로 전체 파이프라인을 연결할 수 있습니다. LLM으로 스크립트를 작성하고, 영상을 생성한 뒤, Suno 사운드트랙을 추가하세요. 이미지 → 비디오 → 음악 워크플로는 멀티모달 AI 가이드를 참조하세요.

자주 묻는 질문