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 |
bpm | BPM 분석 | $0.0008 |
alignedLyrics | 가사 타이밍 정렬 | $0.0008 |
download | 멀티 포맷 다운로드(mp3/m4a/wav) | $0.0016 |
generateMp4 | 가사 영상 | $0.004 |
wav | WAV 다운로드(구버전, 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등은 구조화 데이터 반환. 자세한 내용은 태스크 상태 조회