2026/09/14

Suno V6 API: 기존 연동의 버전 선택과 마이그레이션

Suno V6 API의 V6, Mini, Wild 선택 기준과 이전 버전·snake_case 필드 마이그레이션, 비동기 작업 처리, 트랙 식별자 및 호출 비용을 설명합니다.

reAPI의 Suno V6 API는 기존 오디오 엔드포인트에서 version: "V6", "V6_MINI", "V6_WILD"로 버전을 선택합니다. 기존 연동을 옮긴다면 버전 값과 필드 이름을 함께 확인해야 합니다. 현재 Suno 인터페이스는 snake_case를 사용하며, 이전 버전 값은 검증을 통과해도 생성 단계에서 실패할 수 있습니다.^[1]

먼저 model: "suno-music"에 V6 버전을 명시하세요. 비동기 제출과 폴링 흐름을 유지하고, 후속 편집에 쓸 트랙 식별자를 저장합니다. 요청을 만드는 코드를 수정한 뒤 완료 결과를 읽는 방식도 확인하세요. 모델 이름을 suno-v6로 바꾸는 것은 문서에 나온 V6 선택 방법이 아닙니다.

핵심 요약

version에는 V6, V6_MINI, V6_WILD 중 하나를 보내고, 곡 생성 모델 ID는 suno-music으로 유지합니다.^[1]
기존 camelCase 필드를 custom_mode, negative_tags, audio_id 같은 snake_case 이름으로 바꿉니다.^[1]
중단된 V4–V5.5 값은 더 이상 제출하지 마세요. 스키마 검증 통과가 오디오 생성 가능성을 뜻하지는 않습니다.^[1]
음악 방향이 분명하면 V6, 처리 시간을 줄이고 싶다면 Mini 평가, 새로운 편곡을 탐색한다면 Wild가 출발점입니다. Suno의 설명을 적용한 선택 기준이며 실측 성능 보장은 아닙니다.^[2]
완료된 곡 생성 요청은 두 테이크를 포함해 $0.06입니다. 효과음은 별도로 13 credits가 청구됩니다.^[3]

Suno V6 API 요청에서 달라지는 부분

Suno는 2026년 9월 9일 V6를 발표하면서 세 가지 변형 모델과 이전 세대에서의 전환을 알렸습니다.^[2] 개발자는 제품 발표에 나온 기능과 실제 요청에 넣을 수 있는 필드를 먼저 구분해야 합니다.

발표에는 폭넓은 창작·편집 기능이 포함되지만, 모든 소비자 기능이 reAPI 오디오 요청에 제공되는 것은 아닙니다. 현재 곡 생성 요청은 텍스트 제어와 관련 오디오 작업을 문서화합니다. 소비자용 발표가 이미지나 영상 입력을 언급했다고 임의의 필드를 추가하지 마세요. 구현 기준은 전체 Suno 매개변수 문서입니다.^[1]

Suno V6 문서에서 현재 요청 형식을 확인할 수 있습니다. model은 작업을, version은 그 작업에 사용하는 음악 모델을 선택합니다. 애플리케이션에서도 두 결정을 분리하면 Mini 선택 때문에 곡 생성이 편집 작업으로 잘못 바뀌는 일을 막을 수 있습니다.^[4]

여기서 설명하는 서비스는 reAPI입니다. Suno 자체의 공개 개발자 관심 등록 양식은 아직 선정된 파트너와의 탐색 단계를 설명하며, 운영용 키를 셀프서비스로 발급하지 않습니다.^[5]

V6, Suno V6 Mini, Suno V6 Wild 중 무엇을 보낼까

다음 결과에서 무엇이 필요한지에 따라 선택하세요. Suno는 주력 모델을 정확한 구현, Wild를 예측하기 어려운 탐색, Mini를 더 빠르고 효율적인 창작에 맞춰 설명합니다. 아래는 이 설명을 실제 선택 기준으로 적용한 것입니다.^[2]

API 값	시작하기 좋은 상황	자체 작업에서 평가할 항목
`V6`	장르, 편곡, 가사 방향이 명확함	결과가 음악적 지시를 충분히 따르는지
`V6_MINI`	대기 시간이 중요한 반복 작업	전체 소요 시간과 두 테이크 중 하나가 품질 기준을 충족하는지
`V6_WILD`	편곡을 확정하기 전 탐색	변화가 유용한지, 후속 편집 부담만 늘리는지

Mini는 여기서 더 저렴한 API 등급이 아닙니다. 같은 작업이면 세 V6 변형의 가격이 같습니다. 더 빨리 완료되더라도 줄어드는 것은 대기 시간이며 해당 요청의 표시 요금은 아닙니다.^[4] 이 글에서는 통제된 지연 시간 측정이나 청취 비교를 하지 않았습니다. 자체 작업을 측정하기 전까지 “빠르다”는 표현은 Suno의 제품 포지셔닝으로 받아들이세요.

공정하게 비교하려면 프롬프트, 모드, 다른 제어는 그대로 두고 version만 바꿉니다. 반환된 두 테이크를 모두 평가하세요. 가사나 스타일도 동시에 바꾸면 어느 변경 때문에 결과가 달라졌는지 알 수 없습니다.

각 작업에 선택한 버전을 기록하세요. 연장 문서는 원본 트랙과 버전이 같아야 한다고 규정합니다. 새 곡용 버전 선택기가 후속 연장 요청의 버전을 조용히 덮어쓰면 안 됩니다.^[1]

Suno V6와 V5.5: 버전과 필드 이름을 함께 이전하기

기존 연동에서 Suno V6와 V5.5의 핵심 차이는 요청이 완료될 수 있느냐입니다. reAPI는 V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5를 중단된 버전으로 명시합니다. 스키마에는 값이 남아 있지만, 해당 버전의 생성은 실패하고 환불됩니다.^[1]

실패 지점은 두 곳입니다. 지원하지 않는 필드는 제출할 때 거절될 수 있습니다. 반면 허용된 이전 버전은 먼저 작업을 만든 뒤 나중에 실패할 수 있습니다. POST의 HTTP 상태만 확인하면 두 번째 실패를 놓칩니다.

화면의 모델 선택기 외에 저장된 프리셋과 서버 기본값도 점검하세요. 화면에는 “V6”가 보여도 백그라운드 워커는 과거에 저장한 페이로드를 계속 보낼 수 있습니다.

이전 요청 일부	현재 형식
`"version": "V5_5"`	새 곡 생성에는 `"version": "V6"`
`"customMode": false`	`"custom_mode": false`
`"negativeTags": "metal"`	`"negative_tags": "metal"`
`"audioId": "…"`	트랙 참조 작업에는 `"audio_id": "…"`

전체 Suno 문서는 2026년 9월 13일의 필드 이름 변경을 기록합니다.^[1] 요청 객체를 의도적으로 수정하세요. 저장된 결과나 무관한 연동까지 텍스트를 일괄 치환하면 이전 대상이 아닌 내용도 바뀔 수 있습니다.

새 작업에서는 유효한 V6 원본을 생성한 뒤 이에 의존하는 편집을 시험하세요. V6를 선택하면 모든 이전 트랙 ID가 모든 작업에 맞는 원본으로 변환된다고 가정해서는 안 됩니다.

V6 페이지의 여덟 가지 작업

V6 전용 페이지는 여덟 작업을 다룹니다. 모두 POST /api/v1/audio/generations를 사용하지만 필수 입력은 다릅니다.^[4]

작업	`model`	`version` 규칙
곡 생성	`suno-music`	필수
생성된 트랙 연장	`suno-extend`	필수, 원본 버전과 일치
업로드 오디오 커버	`suno-upload-cover`	필수
업로드 오디오 연장	`suno-upload-extend`	필수, 원본 버전 규칙 준수
보컬 추가	`suno-add-vocals`	선택, 기본값 `V6`
반주 추가	`suno-add-instrumental`	선택, 기본값 `V6`
업로드 오디오 매시업	`suno-mashup`	필수
효과음 생성	`suno-sounds`	필수

전체 제품군에는 18개 비동기 작업이 있습니다. 나머지 열 작업은 이 V6 페이지 밖에 있지만, 모두 버전 필드를 거절한다는 뜻은 아닙니다. suno-replace-section은 기존 task_id와 audio_id 조합 또는 upload_url과 version 조합을 받습니다. 업로드 오디오 분기에는 버전이 필요하고, 기존 트랙 분기에서는 생략해야 합니다. 두 분기를 섞으면 유효하지 않습니다.^[1]

모든 Suno 요청에 공통으로 version을 붙인다면 그 가정을 제거하세요. 필요한 요청 빌더에서만 버전을 선택합니다. WAV 변환, 가사 생성, 음성 작업도 각각 다른 입출력 규칙이 있으므로 곡 요청을 그대로 복사하면 안 됩니다.

첫 V6 요청을 보내고 오디오 기다리기

reAPI 키, 선택한 작업에 충분한 크레딧, 자격 증명을 서버에서 보관할 위치가 필요합니다. 첫 요청은 영감 모드로 간단히 구성할 수 있습니다. prompt가 곡을 설명하고 모델이 가사를 작성합니다.^[4]

curl https://reapi.ai/api/v1/audio/generations \
  -H "Authorization: Bearer $REAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-music",
    "version": "V6",
    "custom_mode": false,
    "instrumental": false,
    "prompt": "A dreamy synthwave track about driving through a neon city at midnight"
  }'

반환된 작업의 id를 읽어 작업 조회 엔드포인트에 사용합니다. 아래 TASK_ID는 실제 값으로 바꿀 자리표시자입니다.

curl "https://reapi.ai/api/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer $REAPI_API_KEY"

제출 성공이 오디오 완성을 뜻하지는 않습니다. 대기·처리 중에는 폴링하고, 실패하면 중단하며, status가 completed일 때 결과를 사용합니다. 폴링에는 크레딧이 들지 않습니다.^[4]

이 글을 준비하며 운영 환경 playground에서 V6 생성 한 건을 실행했습니다. 완료 응답에는 output.audio_urls와 output.tracks가 각각 두 항목 있었습니다. 이는 이 예시의 출력 수를 확인한 것이며, 성능이나 신뢰성 벤치마크는 아닙니다.

output.tracks[].id가 있으면 상위 작업 ID와 함께 저장하세요. 오디오 URL을 audio_id 대신 사용하면 안 됩니다. 문서는 트랙 URL을 보장하지만 빈 메타데이터 필드는 생략할 수 있다고 설명합니다. 후속 작업을 활성화하기 전에 가사·길이·식별자가 없는 경우를 처리하세요.^[4]

정확한 가사가 필요하면 사용자 지정 모드로 전환하고 style과 title도 제공합니다. Suno V6 버전 매개변수는 custom_mode의 의미를 바꾸지 않습니다. 길이 제어는 사용자 지정 모드에서만 적용되며, 정수 목표 범위는 10–360초입니다.^[4]

V6 호출 비용

9월 14일 확인한 Suno V6 요금표에서 곡 생성은 완료 요청당 $0.06, 즉 60 credits입니다. 두 테이크가 모두 포함됩니다. 둘로 나누면 반환 트랙당 $0.03이지만, 이는 산술 환산이며 트랙별로 따로 구매할 수 있는 요금은 아닙니다.^[3]

한 테이크만 쓴다면 실제 채택한 곡의 비용은 여전히 $0.06입니다. 새 생성이나 후속 작업에는 각각 요금이 추가됩니다. Mini를 선택하거나 지원 범위에서 더 짧은 곡을 요청해도 해당 호출의 요금은 줄지 않습니다.^[4]

효과음은 다릅니다. 원래 표시 단가는 $0.0125지만 정수 크레딧 차감은 13 credits, $0.013 상당입니다. 예산에는 원래 요금을 내림한 값 대신 실제 청구 크레딧을 사용하세요.^[3]

자격 증명 설정은 Suno API Key 가이드, 다른 작업 요금은 전체 가격표를 참고하세요. 공식 개발자 접근 여부는 공식 API 제공 현황에서 별도로 설명합니다.

reAPI. Suno API reference. Retrieved September 14, 2026 from reapi.ai/docs/suno.
Suno. Introducing v6. Published September 9, 2026; retrieved September 14, 2026 from blog.suno.com/blog/introducing-v6.
reAPI. Suno V6 public rate card. Retrieved September 14, 2026 from reapi.ai/models/suno-v6.
reAPI. Suno V6: versions, parameters and billing. Retrieved September 14, 2026 from reapi.ai/docs/suno-v6.
Suno. Developer API intake form. Retrieved September 14, 2026 from sunomusic.typeform.com/apiform.