Skip to main content
Suno 음악 시리즈는 생성·연장·편집·스템 분리·분석까지 완전한 AI 음악 워크플로를 제공합니다. 모든 작업은 하나의 제출 엔드포인트를 공유하며 URL 경로의 {operation}으로 구분합니다:
모든 작업은 비동기 태스크입니다. 제출 후 태스크 ID를 받아 상태 조회 API로 결과를 폴링합니다. 반환되는 오디오·커버·영상 등 미디어 URL은 본 사이트 CDN 영구 주소입니다.

Authorizations

string
필수
Bearer Token 인증. API Key 발급:API Key 관리 페이지

공통 사항

  • 요청 본문의 model은 항상 "suno"
  • 기존 작품을 다루는 작업은 task_id(본 플랫폼 태스크 ID, tsk_aud_ 접두사)를 전달. 여러 트랙일 때 audio_index로 번호 지정
  • custom은 모드 스위치: true = 커스텀 가사 모드(prompt가 가사, title/style/negative_tags 적용). false/생략 = 영감 모드(prompt/gpt_description가 음악 설명)
  • max_mode는 고품질 티어(2배 요금). 아래 표 Max 열의 작업에만 적용. custom 필드가 있는 작업은 effective custom이 true일 때만 적용

작업 및 가격

생성

업로드

연장·변환

스템

편집

분석·보내기

에셋(고급)

태스크 수명 주기

  • 태스크 실패 시 선차감 금액 자동 환불
  • download/midi/bpm/alignedLyrics 등은 구조화 데이터 반환. 자세한 내용은 태스크 상태 조회

음악 생성

generation / inspo / sounds / lyrics

연장과 업로드

extend / uploadTask / uploadCover / uploadExtend

편집과 변환

crop / fadeIn / fadeOut / replaceMusic / mashup / …

분석과보내기

midi / bpm / alignedLyrics / download / generateMp4