> ## 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.

# 분석과보내기

> midi 채보, bpm 분석, alignedLyrics 타이밍, download/wav, generateMp4 영상

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

<ParamField body="model" type="string" required>고정 `"suno"`</ParamField>
<ParamField body="task_id" type="string" required>원본 태스크 ID</ParamField>
<ParamField body="audio_index" type="number">트랙 번호</ParamField>

## midi — MIDI 채보(\$0.05)

곡을 트랙별 MIDI 노트 데이터로 변환. `result.instruments[]`에 각 악기 트랙 반환:

<ResponseField name="instruments" type="array">
  <Expandable title="악기 트랙">
    <ResponseField name="name" type="string">악기명. 예:`Electric Piano 1`</ResponseField>
    <ResponseField name="program" type="integer">General MIDI 프로그램 번호</ResponseField>
    <ResponseField name="is_drum" type="boolean">드럼 트랙 여부(pitch는 드럼 노트 번호)</ResponseField>

    <ResponseField name="notes" type="array">
      노트 목록:`start`/`end`(초), `pitch`(MIDI 노트 0-127), `velocity`(0-1)
    </ResponseField>
  </Expandable>
</ResponseField>

## bpm — BPM 분석(\$0.0008)

`result`에 `avg_bpm` / `max_bpm` / `min_bpm` 반환.

## alignedLyrics — 가사 타이밍(\$0.0008)

행/단어 단위 타이밍 정렬 데이터 반환.

## download — 멀티 포맷 다운로드(\$0.0016)

<ParamField body="formats" type="array">포맷:`mp3` / `m4a` / `wav`</ParamField>
<ParamField body="format" type="string">단일 포맷(`formats` 또는 `format` 중 하나 필수)</ParamField>

`result.files[]` 반환. 파일은 CDN에 미러링됩니다.

## generateMp4 — 가사 영상(\$0.004)

가사 자막 MP4 생성 후 `result.videoUrl` 반환(CDN 미러).

## wav — WAV 다운로드(\$0.0016, 구버전)

<Tip>지원 중단 예정. `download`에 `format: "wav"`를 사용하세요.</Tip>

## Response

<ResponseField name="task_id" type="string">태스크 ID</ResponseField>
<ResponseField name="status" type="string">`submitted`</ResponseField>


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