지원 모델

2026-09-18 업데이트 · Suno-API 팀

현재 사용 가능한 생성 모델

고객 요청에는 아래 표에 있는 플랫폼 모델명만 사용합니다. 모델명을 생략하면 기본값인 suno-v6가 적용되고, 이전 세대 모델명도 suno-v6로 처리됩니다.

플랫폼 모델명	표시 이름	용도	상태
`suno-v6`	Suno V6	일반 생성 기본 모델	사용 가능
`suno-v6-wild`	Suno V6 Wild	V6 Wild 변형	사용 가능
`suno-v6-mini`	Suno V6 Mini	V6 Mini 변형	사용 가능

기본 권장 모델은 suno-v6입니다.

스템 분리에 대한 참고

스템 분리는 별도의 고정 기능이며, 곡 생성 모델을 선택할 필요가 없습니다. 스템 API를 호출할 때는 원본 곡과 분리 모드(예: two, twelve)만 전달하면 됩니다. 실제로 반환되는 트랙 수는 응답에 표시된 값을 기준으로 하세요.

`model` 파라미터

생성 계열 API에서 model은 보통 선택 사항입니다.

생략하면 현재 기본 모델 suno-v6가 사용됩니다.
지정하려면 suno-v6, suno-v6-wild, suno-v6-mini 중 하나여야 합니다.
위 표에 있는 플랫폼 모델명만 사용할 수 있습니다.

최소 생성 예시

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "봄날의 첫날을 노래한 경쾌한 포크",
    "model": "suno-v6"
  }'

V6 변형 예시

{
  "model": "suno-v6-wild",
  "description": "실험적인 구조의 전자 음악"
}

종료된 모델

다음 모델은 더 이상 새 요청에 사용할 수 없습니다.

suno-v2
suno-v3
suno-v3-5
suno-v4
suno-v4-5
suno-v4-5-all
suno-v4-5-plus
suno-v5
suno-v5-5

기존 곡과 과거 작업에는 여전히 예전 model_name 또는 model_version이 남아 있을 수 있습니다. 이는 이력 데이터일 뿐이며, 해당 모델로 새 요청을 보낼 수 있다는 뜻이 아닙니다.

구버전 클라이언트 호환을 위해, 종료된 모델명을 담아 보낸 요청은 거부되지 않고 현재 기본 모델인 suno-v6로 처리됩니다. 작업 기록에도 suno-v6로 남고 "모델 사용 불가" 오류는 반환되지 않습니다. 그래도 요청 예시는 가능한 한 빨리 위 표의 현재 모델명으로 바꾸는 것을 권장합니다.

모델 목록 조회

GET /v1/models 응답에는 최소한 다음 일반 곡 모델이 포함되어야 합니다.

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

응답에는 가사 모델, 호환 라우트 또는 내부 모델이 함께 포함될 수 있습니다. V6 곡 생성 모델과 혼동하지 마세요.

V6 변형 선택 기준

대부분의 연동에는 기본 모델만 있으면 충분합니다. 세 변형의 차이는 프롬프트를 얼마나 충실히 따르는지, 그리고 결과의 변화 폭이 얼마나 큰지에 있습니다.

변형	사용 시점
`suno-v6`	설명을 충실히 따르는 예측 가능한 결과가 필요할 때. 기본값이며 프로덕션 파이프라인에 적합합니다.
`suno-v6-wild`	변화 폭이 크고 여러 시안을 비교해도 괜찮을 때. 스타일을 탐색할 때 유용합니다.
`suno-v6-mini`	본 생성 전에 프롬프트를 저렴하게 반복 테스트하고 싶을 때.

어느 변형이든 1회에 2곡이 반환되므로, suno-v6-mini로 초안을 잡고 마음에 든 프롬프트를 suno-v6로 다시 돌려 실제 발표할 버전을 고르는 방식이 실용적입니다.

비용과 환불

요금은 모델이 아니라 요청 단위로 부과됩니다. 1회 생성에 0.6위안이며 2곡이 반환됩니다. 생성 실패 시에는 자동으로 환불되므로 실패한 시도가 잔액을 소모하지 않습니다. 다운로드는 횟수 제한이 없고 별도로 청구되지 않습니다.

API 키 발급

가입 후 콘솔에서 API 키를 만들 수 있습니다. 1회 0.6위안으로 2곡이 생성되고, 다운로드는 횟수 제한이 없으며 휴대폰 번호는 필요하지 않습니다.

API 키 받기 개요로 돌아가기