Suno V5

텍스트 투 뮤직보컬 / 악기다중 버전 API

APIXO의 Suno는 짧은 콘셉트나 맞춤 가사로 보컬 또는 악기 트랙을 생성하는 멀티 버전 음악 생성 라우트입니다. V5.5, V5 또는 V4.x 백엔드를 선택하고, 구조화된 제어로 음악적 방향을 설정하면 승인된 생성 요청당 최대 2개의 MP3 버전과 커버 아트를 받을 수 있습니다.

백엔드

V5.5 / V5 / V4.x

APIXO 가격

$0.12 / 생성

출력

최대 2개의 MP3 트랙

워크플로우

프롬프트 / 맞춤 가사

전달

폴링 / 콜백

작업 공간 로딩 중...

Suno V5 모델 API 요금 체계

Suno는 승인된 생성 요청 건당으로 청구됩니다. V5 및 V5.5는 더 저렴한 백엔드 기준 요청 가격을 사용하며, V4 및 V4.5 계열 모드는 더 높은 요청 가격을 사용합니다.

V5 / V5.5

과금 기준

생성 요청이 수락되었습니다

APIXO 가격

요청당 $0.12

V4 / V4.5 계열

과금 기준

생성 요청이 수락되었습니다

APIXO 가격

요청당 $0.18

백엔드 모드	과금 기준	APIXO 가격
V5 / V5.5	생성 요청이 수락되었습니다	요청당 $0.12
V4 / V4.5 계열	생성 요청이 수락되었습니다	요청당 $0.18

청구 규칙

승인된 요청 하나는 커버 아트워크와 함께 최대 두 개의 MP3 트랙 버전을 반환할 수 있습니다.
요청 가격은 반환된 트랙 수에 따라 곱해지지 않습니다.
이 라우트는 오디오 업로드 편집, 리믹스, 스템, MIDI, WAV 내보내기 또는 음성 복제 기능을 제공하지 않습니다.
이전 V4.x 기능이 필요하지 않은 경우 V5.5 또는 V5를 사용하여 가장 저렴한 APIXO 요청 가격으로 이용하세요.

일반적인 비용 예시

예시: Suno V5.5 생성 5회 = 5 x $0.12 = $0.60

API 액세스 확인 중...

로그인하여 무료 크레딧을 받고 이 모델로 생성해 보세요.

AI와 통합

AI 어시스턴트용 프롬프트를 복사하여 APIXO MCP를 설치하고, 라이브 스키마를 읽고, 이 모델을 앱에 연결하세요.

엔드포인트

작업 생성

POSThttps://api.apixo.ai/api/v1/generateTask/suno

상태 폴링

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}

요청 본문

request_type

async

웹훅을 위해 callback_url과 함께 콜백을 사용하세요.

input

객체

모드, 프롬프트, 레퍼런스, 크기, 재생 시간 및 오디오 설정.

request_type필수

유형select

비동기 방식으로 statusTask 상태를 폴링하거나, 결과가 준비되면 콜백으로 webhook을 받으세요.async · callback

callback_url조건부

유형text

콜백 전송을 위한 공개 HTTPS URL입니다.다음에서만 가능: request_type=callback

mode필수

유형select

생성 백엔드 버전을 선택하세요.V5_5 · V5 · V4_5 · V4_5ALL · V4_5PLUS · V4

customMode필수

유형boolean

사용자 지정 가사 및 스타일 제어를 사용하려면 켜고, 프롬프트만으로 곡을 생성하려면 끄세요.

title필수

유형text

사용자 지정 모드가 켜져 있을 때 필요합니다.다음에서만 가능: customMode=true

style필수

유형string

장르, 분위기, 악기 구성, 보컬 스타일을 설명하세요. 사용자 지정 모드에서 필수 항목입니다.다음에서만 가능: customMode=true

prompt선택 사항

유형string

노래 설명 또는 가사. V5.5, V5, V4.5 모드는 최대 5000자까지 지원합니다.

songDescription필수

유형string

사용자 지정 모드가 꺼져 있을 때 사용되는 프롬프트 전용 모드 필드입니다.다음에서만 가능: customMode=false

instrumental필수

유형boolean

보컬 없이 연주 음원을 생성하려면 켜세요.

negativeTags조건부

유형string

피해야 할 아티팩트나 스타일을 설명하세요.다음에서만 가능: customMode=true

styleWeight조건부

유형slider

스타일 설명을 얼마나 강하게 따를지 결정합니다.다음에서만 가능: customMode=true

weirdnessConstraint조건부

유형slider

값이 높을수록 더 실험적인 결과물이 생성됩니다.다음에서만 가능: customMode=true

audioWeight조건부

유형slider

오디오 충실도와 가사 제어의 균형을 맞춥니다.다음에서만 가능: customMode=true

vocalGender조건부

유형select

선호하는 음색을 최대한 반영합니다.f · m다음에서만 가능: customMode=true

파라미터	유형	필수 항목	설명
`request_type`	select	필수	비동기 방식으로 statusTask 상태를 폴링하거나, 결과가 준비되면 콜백으로 webhook을 받으세요.async · callback
`callback_url`	text	조건부	콜백 전송을 위한 공개 HTTPS URL입니다.다음에서만 가능: request_type=callback
`mode`	select	필수	생성 백엔드 버전을 선택하세요.V5_5 · V5 · V4_5 · V4_5ALL · V4_5PLUS · V4
`customMode`	boolean	필수	사용자 지정 가사 및 스타일 제어를 사용하려면 켜고, 프롬프트만으로 곡을 생성하려면 끄세요.
`title`	text	필수	사용자 지정 모드가 켜져 있을 때 필요합니다.다음에서만 가능: customMode=true
`style`	string	필수	장르, 분위기, 악기 구성, 보컬 스타일을 설명하세요. 사용자 지정 모드에서 필수 항목입니다.다음에서만 가능: customMode=true
`prompt`	string	선택 사항	노래 설명 또는 가사. V5.5, V5, V4.5 모드는 최대 5000자까지 지원합니다.
`songDescription`	string	필수	사용자 지정 모드가 꺼져 있을 때 사용되는 프롬프트 전용 모드 필드입니다.다음에서만 가능: customMode=false
`instrumental`	boolean	필수	보컬 없이 연주 음원을 생성하려면 켜세요.
`negativeTags`	string	조건부	피해야 할 아티팩트나 스타일을 설명하세요.다음에서만 가능: customMode=true
`styleWeight`	slider	조건부	스타일 설명을 얼마나 강하게 따를지 결정합니다.다음에서만 가능: customMode=true
`weirdnessConstraint`	slider	조건부	값이 높을수록 더 실험적인 결과물이 생성됩니다.다음에서만 가능: customMode=true
`audioWeight`	slider	조건부	오디오 충실도와 가사 제어의 균형을 맞춥니다.다음에서만 가능: customMode=true
`vocalGender`	select	조건부	선호하는 음색을 최대한 반영합니다.f · m다음에서만 가능: customMode=true

예시 (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "input": {
      "mode": "V5_5",
      "customMode": true,
      "instrumental": false,
      "title": "Neon Freeway Nights",
      "style": "Synthwave, dreamy pop",
      "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful."
    }
  }'

전체 API 문서

기능

여러 Suno 버전에 걸친 유연한 곡 생성

완성곡 생성

개별 보컬, 악기, 편곡을 조합하는 대신 텍스트로 완전한 음악 컨셉을 구축하세요. 결과는 구조, 길이, 가사 전달, 믹스 면에서 다양할 수 있습니다.

선택 가능한 모델 버전

APIXO는 V5_5, V5, V4_5, V4_5ALL, V4_5PLUS, V4를 제공하여, 애플리케이션이 라우트를 V5 전용으로 취급하는 대신 백엔드를 선택할 수 있도록 합니다.

커스텀 가사 구조

커스텀 모드는 제목 및 스타일 설명과 함께 제공된 가사를 허용합니다. [Verse], [Chorus], [Bridge]와 같은 섹션 라벨을 사용하여 요청된 곡 구조를 구성할 수 있습니다.

보컬 또는 연주곡 출력

동일한 라우트에서 생성된 보컬이 포함된 곡 또는 악기 연주곡만 지원합니다. 악기 연주곡 생성은 두 제작 워크플로우 모두에서 필수적인 'instrumental' 설정을 통해 사용할 수 있습니다.

스타일 및 실험 제어

커스텀 모드는 동일한 음악적 지시에 대해 다양한 해석을 만들어내기 위해 스타일 준수, 기묘함, 부정 태그, 오디오 가중치, 최선의 보컬 음색 선호도 설정을 제공합니다.

두 가지 창의적인 버전

승인된 생성 요청 하나는 각각 MP3 URL과 커버 이미지 URL을 포함하는 두 개의 트랙 객체를 반환할 수 있으므로, 팀은 한 번의 요청으로 대체 편곡이나 연주를 평가할 수 있습니다.

생성 워크플로우

콘셉트를 입력하거나 곡의 구조를 제공하여 시작하세요

프롬프트 전용 곡 생성

LYuHuh

프롬프트 전용

커스텀 가사 및 스타일 생성

`customMode`를 `true`로 설정한 다음, 보컬 생성 시 제목, 스타일, 가사를 제공하세요. 사용자 지정 모드는 부정 태그, 스타일 준수, 실험, 오디오 가중치 및 보컬 음색 제어 기능도 잠금 해제합니다.

사용자 지정 모드

API 상세 정보

Suno 라우트 사양

APIXO에서 문서화하고 검증한 생성, 출력 및 전달 동작입니다.

6개의 선택 가능한 열거형

백엔드

1–500자

간단한 프롬프트

V4: 3K · 이후: 5K

커스텀 프롬프트

최대 2개 버전

트랙

MP3 + 커버 이미지

에셋

기본 15일

보관

사용 사례

Suno 경로에 적합한 음악 워크플로우

작곡

오리지널 곡 컨셉 탐색

아이디어를 여러 버전의 보컬 트랙으로 만들거나, 구조화된 가사와 스타일 방향을 제공하여 다양한 편곡을 비교해 보세요. 사용하기 전에 발음, 가사 정확도, 곡 구조, 원치 않는 유사성을 검토하세요.

브랜드 오디오

캠페인 음악 초안 작성

광고, 소셜 캠페인, 브랜드 콘텐츠를 위한 보컬 후크 또는 악기 컨셉을 생성하세요. 결과물은 창작 초안으로 취급하고, 배포 전 적절한 권리 및 상업적 이용 허가 검토를 완료해야 합니다.

숏폼 오디오

인트로 및 아웃트로 컨셉 제작

팟캐스트, 채널, 스트림, 정기 시리즈의 음악 방향을 개발하세요. 스타일 및 부정 태그 컨트롤을 사용하여 톤을 탐색하면서 믹스 밸런스, 보컬 아티팩트 및 의도한 편집에 대한 적합성을 확인하세요.

인터랙티브 미디어

내러티브 사운드트랙 프로토타입 제작

분위기, 장르, 악기 구성, 강도에 대한 설명을 바탕으로 게임, 예고편, 장면, 가상 설정을 위한 기악 아이디어를 제작하세요. 이 경로는 스템, MIDI, 또는 편집 가능한 프로젝트 세션을 제공하지 않습니다.

참고 사항 및 FAQ

APIXO의 Suno 경로 운영 가이드

통합 참고 사항

제품 페이지 제목은 'Suno V5'이지만, 실제 라우트는 다중 버전을 지원하며 현재 최신 선택 가능 백엔드로 V5_5를 포함하고 있습니다.

Suno는 2025년 9월 23일에 v5를, 2026년 3월 26일에 v5.5를 출시했습니다. v5.5 관련 개선 사항은 V5_5를 선택한 경우에만 적용됩니다.

APIXO는 V4 커스텀 가사는 최대 3,000자, V4.5, V5, V5.5 계열 커스텀 가사는 최대 5,000자까지 지원합니다.

커스텀 스타일은 V4에서 최대 200자, 이후 선택 가능한 백엔드에서는 최대 1,000자를 지원합니다. APIXO는 제목은 최대 80자, 부정 태그는 최대 200자까지 지원합니다.

일반적인 생성 시간은 60~90초입니다. APIXO는 45초 후에 첫 폴링을 시작하고, 그 이후에는 5~10초 간격으로 폴링할 것을 권장합니다.

HfEUvQ

자주 묻는 질문

아니요. APIXO의 제품명은 'Suno V5'로 유지되지만, suno 경로는 현재 V5_5, V5, V4_5, V4_5ALL, V4_5PLUS, V4를 노출합니다. 이는 다중 버전 Suno 음악 API로 설명하는 것이 가장 정확합니다.

`styleWeight`, `weirdnessConstraint`, `audioWeight`는 0에서 1 사이의 값을 받습니다. 스타일 가중치는 스타일 설명에 대한 준수도를 높이고, 더 높은 'weirdness'는 실험을 장려하며, 오디오 가중치는 오디오 충실도와 가사 제어 사이의 균형을 맞춥니다. APIXO는 경로 전체에 대한 기본값을 공개하지 않습니다.

APIXO는 수락된 생성 요청이 두 가지 변형을 반환할 수 있으며, 두 개의 트랙 객체를 포함하는 하나의 resultUrls 배열을 보여준다고 명시합니다. 애플리케이션은 두 트랙이 항상 성공적으로 완료된다고 가정하기보다는 반환된 배열을 파싱해야 합니다.

APIXO의 상세 라우트 문서에는 각 트랙당 $0.12이 아닌, 반환된 변형을 포함하여 생성당 $0.12으로 명시되어 있습니다. V5 및 V5.5에 대해 해당 요금을 명시적으로 표시하며, 이전 백엔드 요금 및 부분 결과 과금은 별도로 공개되지 않았습니다.

오디오 업로드, 확장, 커버, 리믹스, 리마스터, 음성 복제 또는 편집 워크플로우는 문서화되어 있지 않습니다. 결과는 MP3 및 커버 이미지 URL을 제공하며, 가사는 사용 가능한 경우 함께 반환됩니다. WAV, 스템, MIDI, 비디오, 편집 가능한 프로젝트 파일은 제공되지 않습니다.