> ## Documentation Index
> Fetch the complete documentation index at: https://docs.toapis.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Suno 음악 생성

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

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

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

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

## Authorizations

<ParamField header="Authorization" type="string" required>
  Bearer Token 인증. API Key 발급:[API Key 관리 페이지](https://toapis.com/console/token)

  ```
  Authorization: Bearer YOUR_API_KEY
  ```
</ParamField>

## 공통 사항

* 요청 본문의 `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` 등은 구조화 데이터 반환. 자세한 내용은 [태스크 상태 조회](/docs/ko/api-reference/tasks/music-status)

<CardGroup cols={2}>
  <Card title="음악 생성" icon="music" href="/docs/ko/api-reference/audios/suno/generation">
    generation / inspo / sounds / lyrics
  </Card>

  <Card title="연장과 업로드" icon="upload" href="/docs/ko/api-reference/audios/suno/upload-extend">
    extend / uploadTask / uploadCover / uploadExtend
  </Card>

  <Card title="편집과 변환" icon="scissors" href="/docs/ko/api-reference/audios/suno/edit">
    crop / fadeIn / fadeOut / replaceMusic / mashup / ...
  </Card>

  <Card title="분석과보내기" icon="chart-line" href="/docs/ko/api-reference/audios/suno/analysis">
    midi / bpm / alignedLyrics / download / generateMp4
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.