ToAPIsToAPIs
Suno 음악

Suno 음악 생성

Suno AI 음악 생성·편집 API 개요, 태스크 수명 주기와 가격

Suno 음악 시리즈는 생성·연장·편집·스템 분리·분석까지 완전한 AI 음악 워크플로를 제공합니다. 모든 작업은 하나의 제출 엔드포인트를 공유하며 URL 경로의 {operation}으로 구분합니다:

POST https://toapis.com/v1/music/generations/{operation}

모든 작업은 비동기 태스크입니다. 제출 후 태스크 ID를 받아 상태 조회 API로 결과를 폴링합니다. 반환되는 오디오·커버·영상 등 미디어 URL은 본 사이트 CDN 영구 주소입니다.

Authorizations

Authorizationstring헤더필수

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

Authorization: Bearer YOUR_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일 때만 적용

작업 및 가격

생성

operation설명가격Max
generation음악 생성(기본)$0.05$0.10
lyrics가사 생성$0.008-
inspo레퍼런스 오디오 영감 생성$0.068$0.136
sounds효과음 생성$0.0096-
upsampleTags스타일 태그 확장$0.004-

업로드

operation설명가격Max
uploadTask업로드 오디오를 태스크로 등록$0.004-
uploadCover업로드+커버$0.05$0.10
uploadExtend업로드+연장$0.05$0.10

연장·변환

operation설명가격Max
extend지정 시점부터 이어서 생성$0.05$0.10
coverSong다른 스타일 커버$0.05$0.10
remaster음질 리마스터$0.05-
mashup두 곡 매시업$0.05$0.10
replaceMusic구간 재작성$0.05$0.10
sample구간 리샘플(업로드 산출물만)$0.05$0.10

스템

operation설명가격
stems보컬/반주 분리$0.10
stemsAll전체 악기 분리$0.24
addStem악기 트랙 추가$0.05(Max $0.10)
addVocals업로드 소스에 보컬 추가$0.05(Max $0.10)
addInstrumental업로드 소스에 반주 추가$0.05(Max $0.10)

편집

operation설명가격
crop구간 잘라내기$0.008
removeSection구간 삭제$0.008
fadeIn인트로 페이드인$0.008
fadeOut아웃트로 페이드아웃$0.008
adjustSpeed속도 변경(피치 유지 가능)$0.024
concat연장 세그먼트 결합$0.004

분석·보내기

operation설명가격
midi오디오→MIDI 노트 데이터$0.05
bpmBPM 분석$0.0008
alignedLyrics가사 타이밍 정렬$0.0008
download멀티 포맷 다운로드(mp3/m4a/wav)$0.0016
generateMp4가사 영상$0.004
wavWAV 다운로드(구버전, download 권장)$0.0016

에셋(고급)

operation설명가격
persona보컬 페르소나 추출$0.004
createVoice음성 클로닝(깨끗한 보컬 필요)$0.016
vox보컬 추출(구버전, persona 권장)$0.004
createModel커스텀 모델 학습(6-24 트랙)$0.96

태스크 수명 주기

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

On this page